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FOREWORD 


This document Is the user guide for the Flight Design System (FDS), an Interactive aid 
for trajector •, attitude, and consumables planning of Space Transportation System 
missions. c v$ has been devoloped by the Mission Planning and Analysis Division, NASA 
Lyndon 8. 1 ihnson Space Center, Houston, Texas, and by Its contractors. This user 

guide was developed for MPAD by personnel of the Man-Computer Systems Division, Science 
Applications, Inc., Englewood, Colorado, under contract NAS9- 15535. 

FDS has two major components. "Subsystem X" Is a rapid. Interactive planning system 
residing primarily on an Interdata 8/32 computer, while "Subsystem Y" Is a batch-only, 
high-fidelity simulation system residing on a Unlvac 1108. This present version of the 
user guide contains an overview of the entire FDS system, but contains detailed 
Information only on Subsystem X. When Subsystem Y Is better defined. It Is Intended 
that this user guide be augmented with more detailed Information on that portion of FDS. 

This document was developed In an unusual manner. SAI analysts first complied a 
complete list of the Identifiable concepts which must be understood for successful use 
of FDS. The predecessor-successor relationships among these concepts were then 
Identified. The resulting, partially ordered set of concept descriptions might loosely 
be called a "semantic network." On the basis of the content and structure of this 
network, the concepts were then divided Into "modules", which were developed Into actual 
document sections via a technique called "story boarding". Further Information on the 
approach used can be obtained from the authors. Constructive criticisms of the document 
content and/or format would be appreciated by both SAI and MPAD. 

The authors wish to acknowledge the assistance of many MPAD personnel In the definition 
of the material contained In this document. Dave Alexander, the project monitor, 
assisted In a variety of ways, and helped particularly with the design of the example 
problem. Bob Davis and George Wetsskopf critiqued early versions of the user guide 
semantic network and draft user guide sections, and provided considerable assistance In 
understanding the detailed behavior of the FDS. Bern I e Roush provided Information and 
demonstration of the document processing capabilities of FDS. Sandy Price and Jim Cook 
helped convert the examp I e problem scenario to a specific solution plan useable for 
example discussions in the design guide. Others, too numerous to mention, helped 
resolve specific questions, demonstrated capabilities, criticized drafts, and provided 
other kinds of assistance. 
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This User Guide is designed as an aid to the community of users of the Flight Design 
System (FDS). 


The FDS User Guide has two purposes: (1) to prov ide material which aldsJn user, 

understanding of FDS and J_ts environment, and (2)_ to serve as a reference, jaanual-for. the 
use of FDS In flight design . The first section of this document presents Information 
about the Flight Design System In the context of fllghf design as carried out by NASA* 

It also Introduces the FDS user to the structure of FDS and to constructs within FDS 
(such as files of Information or the part of FDS which Interacts directly with the 
user)* The second section of this document Is a guide to the commands available to FDS 
users* In addition, a glossary of Important terms, an Index to terms, and a quick 
reference to the commands of FDS are Included In the Guide. 


The layout of this document provides Its _user with easy access to_ileslrecL.Iiiiormation* 
Each topic Is presented In a two-page "module". Each of these modules Is Introduced by 
an appropriate sentence which specifies the basic point of the module* Each paragraph 
within a module begins with a sentence which Introduces the main topic of the paragraph. 
Specialized types of Information, such as a summary or an example p oblem, are presented 
with a module to aid In quick review (or In finding a module on a related topic). 

Within each module, Important concepts which are Introduced there for the first time In 
the User Guide are printed In capital letters. 


Title of Modu le • 


Basic Point_ 
of Module 
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First sentence 
of paragraph 
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1-1. The layout of the FDS User Guide helps users to access desired information. 
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Each module of the FDS User Guide contains a summary block to aid In quick reference of 
material contained In that module. This block Is highlighted like this, with a red 
background. It Is always located at the top of the right hand page of a module, A user 
who does not wish to read a module In detail may use this block as a quick review of the 
modu I e. 




page of FDS commands . Definitions of Important terms can be referenced easily In the 
glossary section. An Index of the terms used In the User Guide provides page numbers on 
which the terms are discussed. The page numbers on which major definitions or 
explanations appear are underlined. A page of sample commands, showing basic forms. Is 
located In the back of this document, along with some aids to finding desired commands. 


1 1 m 3 BKfl I i« ihH IT iTT* V*i ■fnPI*TMTiTnTI K 


en gaged In flight design using FDS as a tool . Obviously, not all users will access this 
document In the same way. Users who already know Information In a module may wish to 
simply read the summary block or to skip that module altogether. New users may wish to 
read the modules carefully and In order the first time through. All users should be 
able to use this document to become more proficient In their use of FDS. 



Several documents serve as 
reference material for FDS use. 


particular aspects of FDS . The "X 
Processor User Reference Manual** 
provides detailed Information about 
the X Processors. Included In this 
volume Is a guide to the documentation 
function of FDS. The **Y Processor 
User Reference Manual** Is a reference 
manual to the various high fidelity 
simulation processors available on 
FDS. For users who de c ! re a deeper 
understanding ot FDS, the "FDS-2 
Software Design and Description** 
(79-FM-11) Is recommended. Most users 
will not need the level of detail 
presented there, however. Finally, 
hardware manuals are available for the 
various computers, terminals, etc., 
which make up FDS. For most users, 
though, this User Guido and the 
processor reference manuals should be 
an adequate source of Information. 




The example Is printed on a green 
background for easy Identification. 

Not cl I modules have an example 
problem block. By reading through the 
example blocks from front to back, the 
reader can obtain a review of the 
procedures Involved In FDS use. 
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Flight design Is a complex. Iterative process Involving several organl zatlons within 
NASA. 


Eli gilt Design for the Space Transportation System (STS) is a planning process . For each 
flight this process produces a schedule of events that will occur between the lift-off 
and landing of the Space Shuttle. The planned events must satisfy the mission 
objectives and be 
operationally feasible. 

That Is, they must stay 
within the performance 
-apabl I 1 ties of the 
spacecraft. Its crew, and 
the ground support system. 

Several kinds of analysis 
and planning are used to 
produce a flight design. 

Tr ajectory analysis 
specifies launch criteria, 
orbital maneuvers and other 
activities that are needed 
to guide the spacecraft. 

Attitude planning determines 
how the spacecraft Is to be 
pointed so that sensors and 
communication equipment can 
function prooerly and the 
temperatures can be 
controlled. Consumables 
analysis Is used to assure 
that the consumption of 
energy, propellants and 
environmental control 
chemicals Is within the 
limits of the spacecraft. 

Crew activity considerations 
can cause adjustments to the 
plan In order to assure the 
effectiveness and wo I I being 
of the crew members. 


V i rtuall y ail decisions m ade In cods i d s r lug. one aspect of f light design affect -the 
others . For example, trajectory events can drive attitude, crew and consumables 
planning, or crew activities constraints may necessitate trajectory alterations. 

Because of this Interaction, flight design Is fundamentally a process of fitting 
together several different specialty-oriented views of mission activities so that things 
happen in a feasible order and that t h e spacecraft, ground support systems, and crew can 
function effectively. The Integration of the various technical aspects needed to 
accomplish flight design requires the ability to iterate, that Is, to produce 
preliminary or tentative flight designs and then refine or redo those designs until all 
deficiencies are removed. 
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Flight design Is a planning process that uses various technical Input* to produce flight 
plans and profiles for the Space Transportation System. The process teg Ins with a 
request from SPIDPO to MPAD for assistance In developing a Payload Integration Plan. 

From this point, MPAO directs the Iterative process of flight design from Its Initial 
stages of the development of a Conceptual Flight Profile, through a review process 
Involving SPIDPO and CTPO, to the final production of the detailed Operational Flight 
Profile. 


Organizational resoons lb lilt las, and commun leaf Ion mechanisms have evolved In order 
accompi Ish. this Iterative Int egration, task . The fllghi design process begins with a 
„ request from the Shuttle Payload Integration and Development Program Office (SPIDPO) to 

the Mission Planning and Analysis Division (MPAD) for assistance In developing a Payload 
Integration Plan (PIP). The cargo for the flight has already been determined. Thus, 
the objectives for the flight are already established. From this starting point, MPAD 
* develops a Conceptual Flight Profile (CFP). This CFP Is a preliminary attempt to 

produce a flight design that satisfies the Integrated constraints from all the technical 
concerns. It Is also the basic Instrument for Iteration. The various organizations 
within MPAD, the Crew Training and Procedures Division (CTPD), and SPIDPO are the 
principal participants In the review of the Conceptual Flight Profile. A Cargo 
Integration Review meeting and the publication of a final Conceptual Flight Profile end 
this phase of flight design. 


INVOLVEMENT OF GROUP OR ORGANIZATION IN FLIGHT DESIGN 

CUSTOMER 

SPIDPO 

MPAD 

CTPD 

MISSION PLANNING PHASE 

X 

X 



Determine payload specifications 


X 



Assign payload to flight 


X 

X 


Develop Payload Integration Plan 



X 


Develop Conceptual Flight Profile 

X 

X 

X 

X 

Review Conceptual Flight Profile 



X 


Develop Operational Flight Profile 


2-2. The flight design process involves several organizations within NASA. 


Ihfl -CFP Is. the Incut to the development of a detailed crew _ act IvJtyL UmaJine, bv the Crew 
Tr aining and Procedures Division . Iteration with MPAD occurs during this process. 
Finally, about one year before the flight, the development of an Operational Flight 
Profile (OFP) begins. This Is used for flight simulations and for support during the 
actual fl Ight. Approximately five months before the flight, the flight design Is 
completed or "frozen” and the final OFP Is published. 
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The Flight Design System helps In the planning and design of shuttle missions as well as 
providing documentation and other support necessary In the development process. 




process . The most basic requirement of the Flight Design System Is to provide a 
manpower-saving technique to plan essentially repetitive flights a 4 * a density of up to 
20 flights per year. As the number of planned flights Increases, and slmllrrltles 
between flights become evident, operational envelopes will be standardized for specific 
payloads and experiments. For each new flight, a review of previous flights will be 
performed to determine If any of them were similar enough to the proposed flight that 
they may be used as a model. Using the flight retirements and a model flight (If It 
exists) as a starting point, a Conceptual Flight Profile Is generated which meets the 
flight criteria. It Is entirely possible that several flight designers will be working 
concurrently on the same flight or will be using the same model timeline to design 
different f I Ights. 




FDS It a computer system that aids In mission planning and flight design. FDS supports 
tha flight datign procatt by providing Intaractlva simulations, documentation such at t 
PIP Section 4 and PIP Annex, CFP, and OFP, and products such ast Supertape, and Crew 
Simulator Data Peck. FDS It designed to save manpower In repetitive Planning, at well 
at provide tools necessary to design new or unique flights* 


FDS la-UMd as a planning aid 
IhrfluflhQut. the flight das lan pro csss. 

First the CFP Is produced* The CFP Is 
based on a relatively low-fidelity FDS 
simulation from lift-off to touchdown. 

After the CFP I? generated. It will be 
examined for coif I lets In various 
aspects of th*, light* Then It will 
be refined In further Iterations via 
Interactive FDS sessions until all 
major criteria specified In the PIP 
are satisfied* Following publication 
of the CFP, the associated data files 
will be archived* After the CFP is 
reviewed, additional ref Inements of 
the flight profile may be undertaken* 

After the final refinements are made, 

FDS Is used to begin preparing the 
OFP. The OFP represents a 
high-fidelity FOS simulation of an 
entire shuttle mission from lift-off 
to touchdown. After the OFP Is 
planned, produced, and published, a SUPERTAPE and, for the first time, a CREW SIMULATOR 
DATA PACK are produced by FDS These products are used by CTPD to support the 
generation of the crew activities timeline* Any conflicts or discrepancies discovered 
after publication of the OFP will necessitate Iterations of all or part of the CFP-OFP 
development, planning, and publication cycle* 


Pf Doouiwwattai 

re, Swtton 4 *nC 8 
PIP Anrwt 

CFP Iff 

AtowWOit* 

OrtfttfOtU 

0«prM!/(mry/LavKNnQ Data 
NonpfoptMva Cowurauw Munviatiofi 
ProcHrfafea Conumattoi Information 
Soft* floefcot Sooator and Efftamai Tanka — 
Separation and Disposal Oata 

QfP .Svmtffli.Qflr 
Slight Prortla Summary 
AOort Planning Analyst* 

Radiation Ooaapo Analysis 

Supartapo 

Crow Simulator Data Pack 


3-2. FDS assists in the generation of 
several documents and data products. 


FDS aids La document production t hroughout the design process and will save, flight 
design data for future use * A f I Ight designer may generate all or part of the 
FDS-supported document products by obtaining a copy of any standardized, skeletal 
document from the special-purpose document processor (Xerox) and merging It with data 
generated using FDS* The user may verify the merged text at an FDS terminal before 
final processing. As a last step In the flight profile development process, the 
timelines and parameters used by FDS to generate the delivered products, along with any 
supportive Information, will be archived as a history file* This Information may be 
used as a model for future planning* 


in summar y. MPAD uses the FDS In flight design activity from generation of PIP_ 
requirements (long before Liftoff h until I Ight is actuaLly iJown. FDS provides the 

computer simulations that support the flight design >~oce$s. The FDS user performs The 
decision process and FDS performs repetitive analys! math-model execution, 
standardized documentation, arid fine tuning necessary to complete the flight design 
process* 
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An example problem has been selected in Illustrate the use of the FDS* 


Most of the basic concepts discussed In thn User Guide are also Illustrated rlth a 
liDftUU concrete example problem. This proolem Is described In this section, and Is 
used throughout the document# Each discussion of the example problem Is presented on a 
green background. The reader who understands the example prob'em In general terms 
should have the background necessary to comprehend the example discussions which are 
distributed throughout the User Guide* 


Although the example on is not as complex as a typical STSmlsslon. It contains 
realistic elements that frequenti v_eppear_and that are appropriate to JlJustrate the use 
of FDS . The objective of the example mission Is to deploy two payloads. The first 
payload Is a satellite which must be placed In a geosynchronous orbit — that Is, In an 
orbit In which the satellite will remain above a particular point on the earth f s 
equator. The Orb I ter Is not capable of taking the payload to that orbit using Its own 
orbital maneuvering system. Therefore, an upper stage Is attached to the payload and 
will be deployed from the orblter f s cargo bay. That upper stage will perform a transfer 
maneuver from the 0rblter f s parking orbit to the satel I tte f $ final geosynchronous orbit. 
After the deployment of the upper stage and Its payload, the Orblter will maneuver to a 
second orbit and deploy the second payload* 


The e laments aI FDS thflt jxrt used, In the generation of, a flight- design of course* . 

not unJqua . The user Is free to choose the processors to be used, the order In which 
they wilt be Involved, the names of tables employed, and the operating modes of FDS. No 
unique problem-solving sequence can be associated with a given problem. Nevertheless, a 
representative problem-solving process has been assumed for the example problem In order 
to Illustrate FDS capabilities and features. The reader should not assume that the 
solution Illustrated represents the only way the FDS could be used. Experience with the 
system will enable the user to become Increasingly more efficient In the exploitation of 
the FDS capabilities. This Is particularly true as results from previously-solved 
problems are employed as starting points for solving new problems. 



to a geosynchronous orbit by an upper stage maneuver. 


i 

i 

i 
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A single example problem Is used for Illustrative purposes throughout the User 
Guide. Discussions of the example problem appear on a green background. The 
problem Involves two payloads, one of which Is to be placed In a 
geosynchronous orbit. 


Some simplifying assumptions have been made to Insure that the problem Is a manageable... 
example . For example. It Is assumed that the launch date and time have been determined 
previously. Ordinarily, a launch window analysis would be performed to determine these 
parameter values. It should also be noted that the order In which planning Is done for 
the upper stage and for the Orblter, after the first payload deployment, Is entirely 
arbitrary. 


PAYLOAD 1 

TARGET ORBIT (GEOSYNCHRONOUS): 

altitude = apogee = perigee * 19,323 nm. 
inclination = 0 (equatorial) 
eccentricity = 0 (circular) 

SATELLITE WEIGHT AT DEPLOYMENT * 12,542 lbs. 

PAYLOAD 2 

TARGET ORBIT: 

al titude » 200 nm. 
inclination = 28.5 degrees 
eccentricity = 0 (circular) 

WEIGHT * 6,320 lbs. 

LAUNCH: 

DATE * 23 April 1981 

GREENWICH MEAN TIME = 10:36:00 

LOCATION = Eastern Test Range 

,.uC0 ALTITUDE = 57 nm. 

LIFT-OFF WEIGHT * 4,504,485 lbs. 

LANDING: 

LOCATION * Eastern Test Range 

CONSTRAINTS « DAYLIGHT (30 minutes before sunset, after sunrise) 

INITIAL PARKING ORBIT 

altitude » apogee = perigee * 150 nm. 
inclination = 28.5 degrees 

FIRST SEPARATION MANEUVER 

velocity delta-V - 50 fps. 
engine(s) - Foreward RCS 

SECOND SEPARATION MANEUVER 

velocity delta-V » 2.5 fps. 
engine(s) » Aft RCS 


4-2. The example problem uses simple, fairly common orbits and maneuvers. 
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05 DETAILS OF THE EXAMPLE PROBLEM AND SOLUTION 


To help the reader understand the Illustrative material presented elsewhere, details 
about the example problem and the assumed solution process are presented here. 


This example mission Is relatively simple and Involves several aspects that arc likely 
to have been designed previously or which are similar to past missions. The flight 
designer would probably use data and procedures that he or she had stored ror the 
purpose of future reference. In the Illustrations which follow tn this book, the 
assumption Is sometimes made that computer files exist which will be retrieved for the 
purpose of review and modification. At other times. It Is assumed that the designer 
will "start from scratch". Although these two problem-solvtng modes are assumed 
arbitrarily In order to best Illustrate FDS capabilities, It Is also true that real 
world flight design will be a mixture of redesign of previous solutions together with 
original design efforts. 


A normal but not unloue sequence In the flight design process begins with basic 
trajectory design . After launch window analysis and the selection of a launch date, the 
conditions at orbital Injection are determined. The event that Is used as the beginning 
of the orbital phase of the flight Is called Main Engine Cit-Off (MECO). From MECO, the 
orbital maneuvers are laid out. This process proceeds until the approximate deorblt 
conditions can be determined. An analysis of landing opportunities leads to the 
selection of the orbit on which the deorblt burn will bo made. 


After the basic trajectory events are determined, the des ign of the attitude profile can 
be accompl I shed . Crew requirements are factored Into both the trajectory and attitude 
profile design. The completion of the attitude profile design allows an analysis of the 
propulsive consumables to be done. The non-propulslve consumables profiles can also be 
determined. Any violations of constraints or recommendations for more efficient use of 
the spacecraft or crew can cause the events of the flight design timeline to be altered. 


The completion of the basic tlmellnlng. of events pertaining to trajectory, attitude. 
profiles, basic crew activity, and consumables management are collected and documented 
In the Conceptual Flight Profile (CFP) . After approval cycles are completed, the 
detailed Operational Flight Profile (OFP) Is generated In approximately the same 
sequence. The Flight Design System Is used throughout the process of producing the CFP 
and the OFP. 
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One approach to the solution of the example problem begins with trajectory design. 
Trajectory design Involves a series of somewhat sequential planning steps, which 
correspond to the planned trajectory events. Once a satisfactory trajectory design has 
been established, attitude and consumables planning can be Initiated. 

TRAJECTORY ANALYSIS AND DESIGN 

ORB I TER THROUGH FIRST PAYLOAD DEPLOYMENT 
Ascent Trajectory 
Staging 

1st burn of Orbital Maneuvering System (OMS) to achieve parking 
orbital altitude 

2nd burn of OMS to circularize parking orbit 
Deploy 1st payload 

Perform separation maneuver with Reaction Control System (RCS) to 
move orb I ter away from 1st payload 

FIRST PAYLOAD AND ITS UPPER STAGE 

Perform maneuver to change orbital plane and raise orbital altitude 

Perform maneuver to make remainder of orbital plane change and to 
circularize In geosynchronous orbit 

ORB ITER AFTER FIRST PAYLOAD DEPLOYMENT 

Perform OMS maneuver to achieve orbital altitude needed for second 
payload 

Perform OMS maneuver to put shuttle In circular orbit tor deployment 
of second payload 

Deploy second payload and perform separation maneuver 
Deorb It 

Groundtrack check (orb I ter branch of trajectory) 

ATTITUDE ANALYSIS 4 DESIGN 
PROPULSIVE CONSUMABLES ANALYSIS 4 DESIGN 
NON-PROPULS I VE CONSUMABLES ANALYSIS 4 DESIGN 
PUBLICATION OF CONCEPTUAL FLIGHT PLAN 
DETAILED SIMULATION AND ANALYSIS 
PUBLICATION OF OPERATIONAL FLIGHT PLAN 

5-1. There are a number of planning operations involved in the solution of the 
example problem. 
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06 FUNCTIONAL A REAS QF F DS 


FDS consists of four main components: (1) X Processors, (2) Y Processors, (3) document 

processing system and (4) an Executive program. 


.There, .a re two types of appl leaf Ion processors, the X Processors and, the Y Proc.es sars.*, 
.that are de.slgned.-tQ.j?erlonn-jspAc.lf.Ic f.Uahl.dealga-lfl&Rs* The application processors 
may be executed Individually or In sequence to perform part, or all, of a flight design 
task. The most basic requirement for X Processors Is that the fidelity be sufficient 
for producing the Conceptual Flight Profile (CFP) and establishing the feasibility of 
the Operational Flight Profile (OFP). Y Processors generate simulations and actually 
produce the data products required for OFPs. 


X .PROCESSORS consist of a library of 
independent application processors that 
are used as building blocks In flight 
design . These processors may be executed 
in interactive or batch mode and In 
whatever sequence Is necessary to satisfy 
the computational requirements of a 
particular flight design task. That is, 
the user essentially structures a 
special-purpose program by the proper 
selection and sequencing of processors. 

The X Processors are designed to perform 
computational routines In an Interactive 
mode. The fidelity of these processors 
Is consistent with CFP development, but 
may be insufficiently detailed for OFP 
development. The X Processors are 
sometimes collectively called "Subsystem X". 


X PROCESSORS 


ATTITUDE & POINTING 

CONSUMABLES & MASS PROPERTIES 

MANEUVER - TARGETING 

PROPAGATION 

SHUTTLE UPPER STAGE 

TRAJECTORY/AUXILIARY DATA SUPPORT 

UTILITY 

CONTROL, DISPLAY, & SIMULATION 


6-1. Listing of types of X Processors. 


The purpose of Y PROCESSORS Is to 
generate high fidelity simulations., of 
f J jght^irof lies and to produ ce the data 
products required for OFPs . Typically, 
the Input parameters for Y Processors 
will consist of flight profile data 
generated on X Processors and transferred 
by the FDS user to Y Processors, through 
the FDS Executive. Y Processors reside 
on another computer, but are considered 
part of FDS. The Y Processors 
are sometimes collectively called 
"Subsystem Y". 


Y PROCESSORS 


ASCENT SIMULATIONS 
ON-ORBIT SIMULATIONS 
DEORBIT-TO-LANDING SIMULATIONS 
RETURN TO LAUNCH SITE SIMULATIONS 
PROXIMITY OPERATIONS SIMULATIONS 
PROPULSIVE CONSUMABLES-USAGE SIMULATIONS 
SUPERTAPE GENERATION 

CREW SIMULATOR DATA PACKAGE GENERATION 
SPECIAL DISPLAYS 


6-2. Listing of types of Y Processors. 
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FDS has four components: X Processors, Y Processors, a documentation system, and 

an Executive program* X Processors are executed In Interactive or batch mode and 
are used primarily for conceptual flight design. Y Processors are executed In 
batch mode only, reside on another computer, and are used for very detailed 
simulation and design. The documentation system Is used to create formal 
documentation, such as CFP and OFP documents. The Executive Interfaces the user to 
the above functional areas. It provides capabilities for data storage and 
retrieval, editing, and processor execution. 


Iters are, also some special purpose -appl lcal.k?RS-..QLFD.S^jur.I[nad I ^document production* 
The FDS user generates data that will be used In CFPs and OFPs. A special purpose 
processor Is provided that allows the user to merge this Information with the supporting 
text of the CFP and OFP documents 


f 


! 


Ite_£X£CUIJY£ Inter fa ces t he _LLs.er_ 
lo lhe,-Qther. f unctional .areas -and, 
-La-lhe. factional .area 
iirflcesses .and r ssp.fihi s . t a.al 1. .usee 
commands . The FDo Executive Is 
designed to support Interactive as 
well as batch processing with X 
Processors, to Initiate remote jobs 
with Y Processors, and to al low 
access to document preparation 
facilities. The Executive provides 
the user with functional 
capabilities In three areas: data 

storage and retrieval, editing, and 
processor execution. These 
functions enable the user to get 
ready to use the appl icatlon 
processors and provide the user 
with access to master data bases 
and the ability to retain data from 
one FDS session to the next. The 



EXECUTIVE 



4 


T 



V PROCESSORS 


DOC UMENTAT ION FUNCTION 

FIDElITY CONSIj- 
TENT WITH CFf\ 
MAT BE EXICUTEO 
IN BATCH OR IN- 
TERACTIVE MODE. 


HIGH FIDELITY 
CONSISTENT WITH 
OFP. MAY BE EX- 
ECUTED IN REMOTE 
JOB ENTRY MODE 
ONLY. 


SUPPORTS DOCUMENTATION 
PRODUCTS, INCLUDING 
SECTIONS OF PIP, PIP 
ANNEX, CFP, AND OFP. 


6-3. The executive processes and responds to 
user commands and interfaces to other 
functional areas. 


Input and output associated with the processors that perform flight design tasks and the 
order In which these processors are executed Is usually prescribed by FDS toMes. The 
execution control function Is used to control the execution of processors. 


To solve the CFP portion of the example problem using FDS, the user must first 
prepare tables necessary to execute the particular X Processors required In 
the flight design. To do this, the user Interacts with the Executive. 


iicrn ! 


r Yrri it n/r 

Uo t K 


t A t LU 1 Ivh 


The X Processors are then executed, again using the Executive, through which 
all user Interaction occurs. 


! 



When all necessary planning Iterations have occurred, the document processor 
Is executed to produce the CFP document. 
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07 THE EXECUT LYELi MIEBACISJi 1IH JUL-USEB 


The Executive Interacts with the user anc* processes the commands that are used to do 
flight design tasks. 


Ih.fi EXECUTIVE ,1s the £QmoQneni..Qf-the..FD.S 

to the other components . The Executive provides users with a single Interface to these 
various components. Through the Executive, the user can access the X Processors, the 
Y Processors, and the documentation system, and cause data to be transferred among these 
components. The Executive performs four functions for the user — data management, 
processor execution, command processing, and access to the documentation function. 



7-1. There are four basic functions performed by the FDS Executive. 


The DATA MANAGEMENT TUNCTJDii_ls concerned with creating dele.tlncu_storlnQ. accessing, 
and modifying files . In performing a flight design task with the FDS, users will access 
files that contain standard flight profiles, standard processing sequences, flight 
requirements, etc. Files will be created to store the flight profile, and other 
associated data, for the current flight design task. These activities are handled by 
the data management function. 
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The FDS Executive consists of severe! components. All user commands are processed by 
the Command Processor, which determines which of the components to Invoke. The Data 
Management function provides the capability to access, create, delete, store, and modify 
files. The Execution Function controls the execution of X and Y Processors. For 
producing documentation products, the Documentation Function ts used. 


Ihfl-EXECmiQH FUNCTION of t he Executive controls t he 
execution of the processors. This function has two 
principal parts — the X Processor execution 
controller and the Y Processor run submittal 
control ler. The X Processor execution control ler can 
operate in one of four modes — one processor at a 
time (manual), automatic, semiautomatic, or batch. 

The Y Processor run submittal controller causes runs 
using Y Processors to be processed In the 
remote- job-entry (RJE) mode. 


The COMMAND PROCESSOR .provides access to other 
functional components .of the Executive. AM user 
commands are processed by the Command Processor, 
which then determines which component to Invoke. The 
Command Processor prom +s the user with the % symbol, 
after which the user !i puts a command. There Is a 
unique prompt symbol associated with each component 
of the FDS, and the prompt symbol changes to Indicate 
which component of the FDS is active. 


.The DJXIJNENIA T IJQN FUN CT ION prov id es a m eans f or 
lazuli. Mi.tina*-and output of te xt documents* These 
documents Include OFPs, CFPs, and the Flight Design 
Annex to the Payload Integration Plan (PIP). 

Skeletal forms of these documents are stored on the 
7-2. Each component of the FDS Xerox word processing system. The FDS Executive 

Executive performs certain tasks. provides a means to merge flight design data with 

these skeletal forms to produce final documents. 


DATA MANAGEMENT CAPABILITIES 

• Deleting, creating, accessing, 
and editing personal files for 
permanent retention of user data 
from session to session 

• Access to master data bases 

• Entering and storing X Processor 
input and output data 

• Managing (naming, storing, delet* 
ing, etc.) X Processor output data 

• Entering and storing Y Processor 
input and output data 

• Managing Y Processor output data 

EXECUTION FUNCTION CAPABILITIES 

• Control the execution of X 
Processors 

• Submit jobs which execute Y 
Processors 

DOCUMENTATION FUNCTION CAPABILITIES 

• Combine flight design data with 
supporting text 

• Prepare CFPs, OFPs, and parts of 
the PIP documents 


In solving The OFP portion of the example problem with FDS, the user will make 
use of the Y Processors. The Y Processor Job is prepared by setting up an 
Input file. 



The Job Is then transmitted, via the Y Processor run submittal controller, to 
a separate computer on which the Y Processors reside. The job may or may not 
actually be run for several hours. When the Job has run, the output is 
returned to FDS and placed In a file. When the user next signs on to FDS, the 
output Is available for reading and editing. 
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08 DATA STORAGE ABEASJlUHilN. FDS 


There are four major data storage areas over which the user has varying degrees of 
control . 


The. ACTIVE WORK AREA (AWA) Is one of the several areas used hy FDS to store data . The 
AWA consists of random access memory and disk storage, and Is automatically allocated to 
the user at sign-on. Many files may be stored In the AWA, The AWA stores Input data 
for use by the executing processors, and Is used for constructing and manipulating data 
and tables# In addition, all retrievable output data from X Processors are stored 
there. The AWA Is empty when allocated# The user must transfer any desired information 
from MDBs and PDBs Info the AWA# The AWA belongs to the user, and cannot be accessed 
directly by other users# It Is a temporary work space that exists only during a user’s 
session, and Is purged at sign-off unless the user takes action to store the Information 
In a Personal Data -Base . 


Personal 
Data Base 



8-1. FDS has four major data storage areas. 
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FDS has four major data storage areas: AWA, PBD, MDB and YOD. As a temporary work 

space allocated at slgn-on, the AWA stores data for the processors and Is used for 
constructing and manipulating data and tables, PDBs are used for permanent storage of 
all or part of the user's AWA, MDBs contain master flight Information that Is made 
available to ail users. Output data from a Y Processor run are stored In the YOD. 


A P£RSQNALJ?ATA BASE (PDB) ls...a disk storage area ihai .the uMr_j£fln. . c reate, durl.no an ffl. S 
session for permanent storage of data and tables . Through the use of the FDS Exe jtlve, 
the user names the PDB and transfers data between the AWA and the PDB. Single files or 
entire data bases may be transferred In either direction between the PDB and the AWA. 

As a general rule, each PDB should contain files that are used together. The PDB may be 
accessed by a single user or a group of users working together. Each user can have 
multiple PDBs. The user Is responsible for data management for the PDBs that the user 
has created. PDB files are not purged at user sign-off and are deleted only on direct 
action from the user. 


Another major data storage area used 
fry IDS Is the MASTER DATA BASE (MDB) . 
MDBs contain data that all users can 
access. For example, tracking station 
locations and global constants are 
maintained on MDBs. FDS users can 
transfer data from an MDB to their 
AWA. Users can then modify the AWA 
copy of this Information to fit their 
own requirements and store It In a 
PDB. However, users cannot create, 
modify or write to an MDB. The MDB Is 
a read-only source of data and Is 
created and maintained by FDS support 
personnel. All MDB names begin with 
"II". No other data areas can have 
names beginning with these two 
characters. 


Lastly, the Y-QUTPUT DATA (YOD) area 
Is Jihere the output irom Y Processor 
Jobs Is stored . YOD files are crealed 
by user-Inltl ated Y Processor runs. 
Each file name Is derived from the job 
name of the Y Processor run that 
created It. Files can be transferred 
from a YOD to the AWA and modified, 
stored In a PDB, or used In another X 
or Y Processor run. The user Is 
responsible for managing data Ir, YODs 
as well as deleting a YOD after It Is 
no longer needed. All or portions of 
the YOD may be used to create files 
within the AWA for access by the 
X Processors. 


In preparing to develop the flight 
design for the example problem, the 
user might begin by obtaining 
Information about a prior flight which 
has similar properties. Such data 
would ordinarily be obtained by 
accessing the PDB associated with the 
prior flight. The user might also 
obtain global constants and similar 
data from one or more MDBs. 



This Information Is all obtained by 
moving It Into the AWA, where the user 
can edit It, delete portions of It, 
etc. When the user Is finished with 
this Initial terminal session, the 
resulting data should be saved by 
storing It In a new PDB. This PDB can 
then be accessed In future sessions 
dealing with this particular flight. 
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09 FILL .HPES 


In addition to the four storage areas, FDS has six explicit file types, which differ In 
form and purpose. 


A DATA ELEMENT (DE) Is a collection of relat ed Input or output_data for a given 
X Processor . Grouping such Information together and storing It under a user-defined 
name provides a convenient mechanism for managing large amounts of processor Input and 
output data. A DE may be stored In an MOB, In a user's PDB or In the AWA. When It Is 
In the AWA, It can be accessed by processors. Processor-to-processor communication can 
be achieved by using an output DE from one processor as an input DE for another 
processor. The user can also create DEs from the Information that Is returned from 
V Processors In the YOD storage area. 


Any DE that Is too Larfle. lo h& stored r a ndom-acces s memory por ti on o f t he A WA I s 

stored as a D I SK -RE SJDENT_D AT A ELEMENT (DRDE) . DRDEs are constructed by the execution 
of processors, which determine their format and contents. Although DRDEs have the same 
function as DEs, they differ In their form. In the manner In which the data they contain 
Is accessed, and In the fact that users cannot explicitly create a DRDE. A DRDE may be 
stored In a PDB or MDB, but only the name and character Istlcs of the DRDE are stored In 
the core-resident portion of the AWA. Since a DE Is structured as an array, the 
contents can be accessed by subscripting. Because a DRDE has a different structure. Its | 

contents must be accessed differently. I 


i 

i 


Personal 


Data Base 



i 


i 

S 


9-1. Six types of files can reside in the AWA, PDBs, or MDBs. 
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In addition to the four data storage areas already discussed* FDS has six file 
types. The various file types differ with respect to the user's capabilities to 
Initialize* change* and control their contents. The six file types are DE, DRDE* 
IT, ST* LT* and YOT. Any of these file types may reside In the AWA* POB* or MDB 
storage areas. 


An.. INTERFACE TABLE (IT) Is assoc tatad w ith each X Processor and provides a mapping of 
user-specified Input and output data It ems to the parameters programmed Into the 
processor . X Processors can read data from ITs, and can read and write to and from DEs 
and DRDEs. For each value read or written by the X Processor, the IT contains either 
the corresponding value or the name of a DE or DRDE (or, for document production, the 
name of a linkage table). At the time an X Processor Is created, the specifications for 
Its Interface table are defined. Each Interface table, therefore. Is built to the 
unique specifications of one X Processor. A "default" Interface table for each 
X Processor has been constructed 
by FDS support personnel. The 
user may modify this table to 
create new tables for specific 
tasks. 


A LINKAGE TABLE (LT) Is used as 
lmm t. to the documentation system 
and Is Identical In structure to 
an Interface table. However, It 
Is associated with a document 
rather than with an X Processor. 
It serves to provide a 
correspondence between the user's 
data values and the corresponding 
reserved spaces In a skeletal 
document. 

PDB 



MDB 

In working on the example problem, 
information generated about a prior 
f I Ight may be used. From a PDB, for 
example, the user could retrieve the 
sequence table and associated 
Interface tables used on the prior 
flight. If the example problem 
Involves use of an X Processor that 
was not used on the prior flight, the 
Interface table associated with this 
processor could be retrieved from an 
MDB. 



Type 

Purpose 


POB 

long-term storage of user data 

ft 

m * + 

Ssl 

MOB 

long-term storage of master data 


YQD 

User-accessible storage of V Processor output data 


0 E 

Collection of processor Input or output data 


ORDE 

large collection of processor Input and output data 

K 

>> 

IT 

Execution control of X Processors 

►- 

4i 

IT 

Execution control of documentation system 

Z 

ST 

User-defined and controlled command execution 


YDT 

Control of Input to Y Processors 


use. 

A SEQUENCE TABLE (ST) Is a collection of 
FDS_ commands stored for later execution. 
These commands can Invoke FDS Executive 
functions and cause X Processors to be 
executed. The purpose of a sequenco table 
Is to provide the user with the capabll Ity 
for defining and executing often-used 
sequences of commands. A typical use of a 
sequence table Is to Invoke, In turn, each 
of the X Processors which correspond to the 
events (e.g., orbital events) on the 
time! Ine. 


A Y-DATA TABLE (YDT) Is a collection of 
Information that defines the control and 
data Incuts required to execute 
Y Processors . Y-Data Tables provide a 
means to create and control the Input data 
for Y Processors. They can also refer to 
DEs used to store output data from 
X Processors, which can then be used as 
Input data to Y Processors. The Y-INPUT 
DATA file, which Is the actual file that Is 
used by Y Processors Is built from the YOT 
by fhe FDS Executive. 
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10 BAIAJMAMACEMSNT 


Data mana^iient Is concerned with creating, storing, accessing, modifying, and deleting 
files and data bases. 


-ST sequence table 

-IT interface table 

-LT linkage table 

-YT Y-data table 

-DE data element 

-OF disk-resident data element 

-PD personal data base 

-MD master data base 

-YJ Y-output data 

-XJ X Processor job 


10-1. All file and data base names 
are unique when they are qualified !-' 
a classification code. 


A file Is a col lection of related 

informations a data base Is a coll act Ion. 

of flies . A group of related Information, 
or data, such as an Interface table for a 
particular processor. Is stored as a file. 
Multiple flies, which are also related In 
some fashion, can be stored as a data base. 
When qualified by a classification code, 
all of a user's flies and data bases have 
unique names that are used to access them. 
Data base nnmes can also be qualified by 
the access code of the user who creates 
them. Users can control access to any data 
bases created under their access codes. 


The operations that can h& jiaiilaangd on a file depend on the ..typa. LL-Ls. and who smi It. 
Some flies, such as those In a MDB, are "read-only"; that Is, they can be read but not 
modified or written to. Files that are stored In PDBs, however, can be modified* 


Flies and data bases must be stored on a dlsk^in order to be saved, but some files can 
reside temporarily In the random- access-memory portion of ^fhe AWA . Between FOS 
sessions, all data bases and files that the user has saved reside on disk. During the 
FDS session, however, some of these files can be In the AWA. Large files cannot be 
stored In the random-access memory portion of the AWA and must be kept In the 
disk-resident portion of the AWA, as DPOEs. The user must be aware of which files are 
DRDEs, since some FDS functions can only be applied to random-access memory-resident 
files and not disk files* 


Users, are responsible for managing .an v_ 
files or data bases, that they create. 

Cause to be crested . When users create 
files, they are responsible for saving 
those files In an appropriate data base, 
making any modifications to those files, 
and deleting those files when they are no 
longer needed. Once created and saved, a 
file will remain on the FDS until the user 
explicitly deletes It, Since file storage 
space Is limited, failure to delete old 
files may prevent the user from having 
sufficient room to save new flies* 


X Processors and Y Processors return data 
to the user i It Is the userJ-S. 
responsibility to manage these data . The FDS X and Y Processors aid In the flight 
design process by calculating data for the user. When using these features, the user 
specifies where the output data are to go. The user must decide which of this 
Information can be deleted and which must be saved and where to save It* 



10-2. Data can be transferred from one data 
base or data storage area to another. 
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The FDS user hat certain responsibilities for data management. Data management Is 
concerned with creating, storing, accessing, modifying, and deleting files and data 
bases. Because file types and data storage areas differ In their function, some data 
management actions apply only to certain files or data storage areas. 


Whan tha user create s files and data bases, certain naming conventions must be followed. 
All files and data bases can be classified as to type and the classification code Is 
sometimes used. In addition to the name, to Indicate which file or data base Is being 
referred to. For example, sequence tables are classified with -ST (e.g., TAB1-ST) and 
Interface with -IT (e.g., TAB1-IT). All flies and data baoes that the user 

creates must kave unique names, when they are qualified by type. No two files or data 
bases of the same type can have the same name. 


Different file types exist because they are stored and used differently. For example. 
Interface Tables and Sequence Tables are used for different functions. Data Elements 
and Disk-Resident Data Elements are used for similar purposes, but are stored 
differently and, as a consequence, must be used slightly differently. The user can tell 
what type a file Is by looking at the classification code. 


User data can be st ored In one of four data storage areas on the. FDS . These areas, 
which were described earlier, are the Active Work Area (AWA), Personal Data Base (PDB), 
Master Data Base (MDB), and Y -Output Data (YOD) area. Any file type, such as a sequence 
table, Interface table, etc., can be stored In the AWA, PDB, or MDB. A YOD can only 
contain the data returned from Y Processors. The user can read the Information In a 
YOD, but cannot write to a YOD. Interface tables, data elements, etc., that are to be 
used by the X Processors cannot be stored on YODs. 


One type of executive command allows the user to transfer flies among, data storage 
areas . These commands allow the user to save AWA data In one of the other storage a>"oas 
or to retrieve data from one of these areas Into the AWA. The commands that are used 
differ slightly as a function of the file Involved. 


ALLOCATE: create DE in AWA 
APPEND: append portions of AWA 
to existing PDB 
CLEAR: purge AWA 
COPY: copy and rename table, DE, 
DRDE, PDB, or YOD 
DELETE: delete table, DE, DRDE, 
PDB or YOD 

GET: retrieve portions of MDB 
or PDB into AWA 
INSERT: combine portions of 
tables 

RENAME: rename table, DE, DRDE, 
or PDB 

STORE: copy portions of AWA to 
new PDB 

SUBSTITUTE: replace contents of 
existing PDB 

YMOVE: copy portions of YOD to 
a DE in AWA 


10-3. These commands are used to 
perform data manaoeinent functions. 


In solving the example problem. Interface 
tables, sequence tables, DEs, and DRDEs 
will be created. All of these files could 
then be stored in one data base. For 
example, we cot Id create a PDB for the 
example problem and call It EXPL-PD. 

expl-pd] 


ITs, Sis, etc. 


When working on a later flight. It would 
Ihen be possible to retrieve these files 
from EXPL-PD, modify them for the current 
problem, and store them In a new data base* 
We could also delete the entire data base 
or selected files, If we were certain they 
would not be used again. 


Ur, STs, etc. hH PROB-PD 
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11 


JlflEffACEJABLES 


Each X Processor has an Interface fable that controls execution of the processor and 
defines input and output parameters. 


An. 1„n.tflri.r_B Table (IT)_ls a named and formatted collection oi parameter attributes and 
.values assocjfltfld With one X Procg&sor* Each IT Is constructed to match the 
specifications of the processor that wlU use It. At the time an X Processor Is 
created, the specification for Its IT Is defined and FDS support personnel construct the 
"default" IT. ITs define a list of Input and output parameters for each X Processor, 
and provide a mapping of the user-specified Input and output data to the variables In 
the X Processor. Since some of the Input variables may determine the 'unction of the 
X Processor, ITs are also used to control the execution of the X Processors. 

X Processors can read data from ITs, and can read and write to and from DE C and DRDEs. 
For each value read or written by the X Processor, the IT contains either the 
corresponding value or the name of the DE or DRDE (or, for document production, the name 
of a I Inkage table) . 


As a processor reuu_Lres a -particular Input from an. 1T^ or the name of an output DE or 
DRDE, the IT Is consulted . At the time the IT Is consulted, the particular element must 
be present. If It Is not, the IT editor Is Invoked and the user must supply the missing 
Information. If the missing information Is marked as required by the application 
processor, the editor will be Invoked before the processor can be executed. If the 
Information Is optional f the editor will only be Invoked when the Information Is needed; 
that Is, during execution of the X Processor. (IT editor functions will be discussed In 
detail In a subsequent section.) It Is Important to remember that X Processors can read 
from ITs, but they do not write to ITs* Input data that are required by a processor can 
either be read from a DE or DRDE that Is named In th© IT or be read directly from the 
IT, Output from processors, however, can only go tr DEs or DRDEs whose names appear in 
the IT; they cannot go directly to the IT. 


X Processor requires data for ARRYI and queries IT. IT returns data to 
X Processor. 


X Processor 
ARRYI 


IT 

- ARRYI - 9,7,8 

i - - 


X Processor has output and queries IT (1) for location of storage area for 
output data. IT tells X Processor to write to (2) Data Element INTOUT. 


X Processor IT INTOUT-DE 



11-1. An X Processor can read values directly from an IT, but can write only to a 
DE or DRDE named in the IT. 
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Interface Tables are required for all X Processors, ITs define Input and output 
parameters for X Processors. The format for ITs Is pre-deflned and can be found In 
default or existing ITs, Default ITs can be obtained automatically from the system. 

X Processors can read from ITs, and can read from, or write to, data elements named In 
the ITs. Linkage Tables are similar to ITs, but are used In the document processing 
function. 


ITs for a .particular processor have a c onstant, pre-deflned format . This format Is 
defined by the processor Involved. The pre-determlned format for ITs can be found in 
default ITs (which are "templates" constructed by FDS support personnel), or In existing 
ITs. Each processor has certain required parameters, but may also have optional 
parameters. The default ITs generally contain default values for those variables which 
the user is unlikely to change; otherwise, variables in the default IT are Incomplete 
and/or missing. The user can create a specific IT by editing the default IT (or other 
existing ITs), adding the missing and/or Incomplete entries, and saving the new IT. 
Interface tables generated by the user are automatically stored in the user’s AWA; 
however, the user may also store ITs In PDBs, or automatically receive default interface 
tables from the system. During processor execution, the IT must be In the AWA. It 
should be noted that users are responsible for managing any ITs they create. This 
Includes naming, modifying, deleting, etc. 


A Linkage Table (LT) Is structured exactly the same __as_ an Interface Table, but is used 
Input to the documentation system . Generally speaking, ITs will point to an LT (as 
If It were a DE or DRDE) to satisfy data requirements ,or a particular document segment 
which Is being processed by the document processor. LTs are created In the same manner 
as an IT, have the same basic structure/format, and changes are made to LTs In the same 
manner as ITs. The difference Is that an LT defines the list of input parameters for a 
particular document/segment (rather than for a particular X Processor) and Is used to 
control the execution of the document processor. LTs are discussed further In 
connection with the document processing function. 


In the example problem, one of the trajectory 
maneuvers Is the "OMS-2" maneuver used to 
circularize the Initial 150-nm. orbit of the 
shuttle. The basic computations associated with 
planning this maneuver will be done by the 
General-Purpose Maneuver Processor (GPMP). GPMP 
Is an X Processor which computes a single vehicle 
Impulsive maneuver which Is Initiated at a 
specified maneuver point In the vehicle orbit and 
Is targeted to a specified final orbit condition. 
The Interface Table associated with a particular 
execution of this processor contains Information 
which describes the particular maneuver. In the 
case of OMS-2, the selected maneuver Is 
Identified as "CIRC", for circularization. The 
Interface Table also names the data elements 
which are to contain the state vectors which 
describe the state of the orb I ter before and 
after the maneuver. In the case of OMS-2, this 
Information will be retrieved from, and stored 
In, a data element called "RESULT". The 
Interface Table contains a variety of additional 
Information dealing with other selected options, 
physical units to be used, display(s) to be 
produced, etc. 


Interface Table 




12 DETAILED CQNTEfflSJff. INTERFACE T ABLES 


Each entry of an Interface Table consists of an entry number, a parameter keyword, and 
Information which defines the value(s) of that parameter. 


Each entry of an Interface Table consists of an ENTRY NUMBER and a DATA FIELD. The 
entry number Is a numeric field (range 1-170) that uniquely Identifies the table entry. 
Entry numbers are used, for example, to Identify entries to be changed. Interface Table 
entry numbers are preassigned and cannot be changed by the user. The data field In an 
IT contains parameter names and associated value fields. The value field may consist of 
one or more data values. Alternatively, It can be a reference to a DE or DRDE where 
data values may be found for input, or where output values are to be stored. IT 
variables are of three types — Input, output, and Input/output. IT output and 
Input/output variables must contain the names of DEs or DRDEs (In the AWA) where data 
values are to be found and/or stored. Data values can be stored In an IT only for Input 
variables. 


1 ,3E0C0N 

a 

MGE0C0N 

( t X identifies MOB element) 

2,PHYC0N 

a 

MPHYCON 


3,S£SC0N 

a 

ISESCON 


4,0$PC0N 

X 

ISESOON 

(! Indicates a configuration controlled 
DE built by a processor) 

5,BDATE 

9 

IBOATE 


6.P90C0N 

a 

10, 1.0E-4, 6.0E-4, 75. 

(array of literal numbers) 

7, INVEC 

a 

RESULTd ,3) 

(RESULT Is a data element allocated by user) 

0, TV) RUST 

a 

t .200000E+04 


9,I$P 

• 

3.131999E+02 


10'ENGID 

» 

"OMS " 


! 1 ,MAN 10 

■ 

"CIRC" 

(CIRC Is the circularization maneuver) 

1 2,DEIV0PT 

• 

"IVLH" 


1 5 ,ALT0PT 

w 

"ALT " 


22, CO 

9 

2.0 


23, AREA 

9 

2690. 


24,DENSM0DL 

9 

t :0ENSMD 


25,$0LAFLUX 

9 

IISOLRMD 


26,GE0P0TEN 

9 

4 

(4 means missing data to be suppl led by user) 

27,SYPR0P 

9 

"AEG « 

28,01 SPLAY 

9 

"TRM * 

(• symbol describes Input data) J 

29,GPMPTET 

% 

RESULTd ,3) 

(9 symbol describes output data) 9 

30, SUMTAB 

% 

ICIRTAB 

1 


12-1. The Interface Table for an OMS-2 trajectory maneuver illustrates many 
of the possible features of ITs. 


An IT ent ry can be MISSING or INCOMPLETE . An " I ncomp I ete" entry Is one In which the 
parameter name Is present, but one or more data fields have not been filled In. The & 
symbol signals FDS of this condition. A given entry may have multiple Incomplete 
fields. The &LABEL symbol Is like the & symbol alone, but a label of up to seven 
characters can be added to aid In Identifying what Is left Incomplete. For example, If 
the Incomplete Item Is the name of a data element containing a state vector, &STATEV 
could be used to Indicate that this required Item Is a state vector. If a parameter Is 
not present at all, ft Is "missing". Since all required parameters are always present 
(even If Incomplete), only optional parameters can be missing. 


Values ent ered In tables may be of d I f ferent DATA TYPES. Data type refers to the way 
that the value Is represented. For example, Integer data types cannot Involve decimal 
points, while real data types can. Each data type (e.g., 6 and 6.0) has a different 
representation In the computer. Processors require certain data types to be used for 
each of their Input and output values. 
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ITs consist of entry numbers and associated data fields. Entry numbers Identify each 
table entry. Data fields contain parameter names and value fields. Value fields denote 
one or more data values, or locations of Input data, or locations In which output values 
are *0 be stored. & or &LABEI may be used In value fields to Indicate missing or 
Incomplete data to be filled In later. Parameter attributes are defined for each 
X Processor. Attributes displays consist of parameter name, class, type, use, and 
dimensions. 


QAIA-IYfiES 


I « INTEGER — 1. -7, +17 

— consists of digits and an optional sign (t or -). 

R * SINGLE PRECISION REAL — 6.12, -17.23E01, 12.1E+C2, 17.3E-02, 4E2 

— consists of digits, an optional decimal point, an 
optional sign, and an optional scale specification. 

0 » DOUBLE PRECISION NUf«ERS — 6.12, -17.23001, 12.10+02, 17.30-02, 402 

— like single precision, but uses 0 Instead of E. 

Cn * CHARACTER DATA — "AB\ "XX17BC* 

— alphanumeric data enclosed In quote ("> marks. Character data 
Items consist of either 4, 8, 16, 32, or 64 characters (e.g., C16). 
You may use fewer characters than those al lowed, but not more. 

M » MIXED TYPE 7, "AB", 16.2003 

— a fixed combination of the above types. 

F * FREE DATA — 6, -J4.2E03, «EXPL" 

— a random, or unconstrained, combination of the above types. 

T - TIME 0ATA — 10:9:15:32.1 

— a time expression (see Appendix 0). 


12-2. An Interface Table may use one or more different data types. 


Each^X Processor has .predef ined_Input/ output attributes . The attributes are determined 
at the time the X Processor Is added to the FDS library and can only be altered by FDS 
support personnel. Attributes of a particular X Processor serve as a foundation from 


which Interface Tables are constructed. Use of the ATTRIBUTES command will display a 
given X Processors artrlbutes. The attributes display provides, for each parameter. 
Its entry number, name. Its data class (DE or DRDE), data type, dimensions (size or 


subscripts), and codes Indicating Its required or optional nature and Its use as Input, 
output, or both. 


1 ATTRIBUTES DISPLAY 

FOR 

PROCESSOR GPMP 


VERSION 6 


ENTRY 

KEYWORD 

SIZE 

ROW COL 

CLASS 

TYPE 1/0 

R/0 

1 

GE0C0N 

60 

15 

DE 

D I 

R 

2 

PHYC0N 

60 

15 

DE 

D I 

R 

3 

GSL 

4 

1 

DE 

C I 

R 

4 

LBMKG 

4 

1 

DE 

0 I 

R 

5 

FTM 

4 

1 

DE 

D I 

R 

6 

SESC0N 

28S 

144 

0E 

F I 

R 

7 

BDATE 

164 

82 

DE 

F I 

R 

8 

PR0C0N 

14 

7 

DE 

F I 

R 

9 

INUEC 

56 

28 

DE 

F I 

R 

10 

thrust 

2 

1 

DE 

R I 

R 

11 

ISP 

2 

1 

DE 

R I 

R 

12 

ENGID 

2 

1 

DE 

C4 I 

R 


12-3. Use of the ATTRIBUTES command will display the attributes 
of a specific X Processor. 


An Interface Table used by GPMP to circularize the Initial 150 nm. shuttle 
orbit Is presented In Figure 12-1. All of the parameter names necessary to 
calculate the example problems OMS-2 circularization maneuver are present. 

With one exception, the Individual data fields are complete. Only entry number 
26 contains a data field that still must be completed by the user. The IT 
contains examples of Input vaiues (e.g., entry number 6), Input DEs (entry 
number 3) and output DEs (entry number 30), as well as a variety of features 
discussed In the figure. It would be useful to consider, together, all three of 
the figures In this module* 
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13 


X Processors are used for flight design computations which do not require detailed 
simulation, and are fully described In the X Processor User Reference Manual. 


As preylpusly explained*, one Qf the, major components .of ±he. FlJaht Design -System Is. the 
library of X Processors . These Independent application processors are used as building 
blocks In flight design. X Processors are designed to perform the computational and 
documentation support requirements of flight design tasks which lead to CFP development. 
The fidelity of these processors is consistent with CFP development, but may be 
Insufficiently detailed for OFP development. X Processors may be executed In a 
multi-user interactive environment or. If the user specifies, X Processors may be 
executed In a background (batch) mode. In either case, the processors may be executed 
individually or In sequence. 


The General Purpose Maneuver Processor (GPMP) is one X Processor, that Is frequentl y- .used 
In the flight design process . GPMP computes a single vehicle Impulsive maneuver that Is 
Initiated at a specified maneuver point In the vehicle orbit and Is targeted to a 
specified final orb It cond Ition. GPMP includes 13 commonly used I mpu I si ve maneuvers. 
However, a particular Shuttle mission may require an impulsive maneuver not present In 
GPMP singular options. In this case, a combination of GPMP maneuvers may enable the 
user to achieve the desired results. For a detailed description and explanation of GPMP 
capabil ities and uses, as well as the capabil Ities and uses of the other X Processors, 
the X Processor User Reference Manual should be consulted. ThaT manual contains 
Information on the purpose, assumptions, computational methods, and Input/output 
requirements of each X Processor. 


| GPMP PROCESSOR INTERFACE TABLE | 

frmpt 

imrMtrttr 

1 

1 

.luaai 

1 

1 

Jut. 

i ! 

Uu. 1 


1 Tain.. ttcrH 

I In default 

1 

1 

GEOCON 

i D£ 
1 
t 

1 

1 

1 


i R1 i 

i i 

i i 


! tier con 
1 
1 

i Geophysical constants array, master data base 
J element 

PMYCON 

1 DE 
1 
1 

1 

1 

1 

1 


i i 

1 RI 1 

1 1 

t 1 


1 11 PMYCON 

1 
I 

i Physical and mathematical constants, master data 
j base element 

SESCON 

! DE 

l 

1 

1 

| 


! ri ! 

i i 


1 1SESC0N 
1 

i Session constants array 

DSPCON 

! K 

1 

1 


! Ri t 1 


| ! SESCON 

i Olsplay constants array 

BOATE 

HI 

1 

1 

1 


l RI 1 

76 

j IBOAIE 

t 

* Basctlme data array 

PROCON 

! de 

1 

1 


! ri ! 

4 

1 

1 

! GPMP limits and tolerances 

IfIVEC 

1 DE 

1 

1 

N 

i RI I 

16 

1 

1 

I 

J Posltlon/vcloclty Inpot state vector 

THRUST 

i DE 

i 

1 

1 

| 

R 

! RI i 

i t 

1 

1 

1 

j 

1 Vehicle thrust magnitude 

ISP 

m 

1 

1 

R 

! R i ! 

1 

t 

1 

j Vehicle specific Impulse, seconds 

ENGID 

I K 
1 
1 
1 
1 
1 
1 
1 
1 

1 

1 

1 

1 

1 

1 

t 

1 

1 

1 

| 

C4 

i RI i 

i } 

i i 

t i 

» * 

i t 

i i 

i i 

j i 

I 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

| 

i 

j Propulsion system Identification code 
| (1) "SRB* - Solid Rocket Boosters 
J (2) "SSME" • Shuttle System Main Engines 
j (3) "OHS" • Orbital Maneuvering System 
j (1) "RCSA" ■ Reaction Control System - AFT 


1 

1 

i 

1 

1 

_L 


i i 

i i 

j i_ 


1 

1 

J 

! (5) "RCSF" ■ Reaction Control System - FWD 
! (6) "SOS" - Shuttle Upper Stage 

i 

■ 1 EW» 
0 1 01 
r t moi 
ft t 
s 1 

i 

1 

I Htt 
tr*>r« 

II rtnt* 
IfttKeal 
tO-Dvfel 


Cl 

ct 

Clft 

Cjt 

| | foruat upeeiflcalton*: N***(MTP*...01yFeJ 

1 Kfc 1 

|ftU R.qwtrrt AT/TO *\ 1 

101- Optional Input Uf /CO l fr* 1 1 

|R0 - Output 0I/R0 I ^ 1 

l00 - Option*! Output 01/00 J [ 


13-1. For each X Processor, the X Processor User Reference Manual provides 
detailed input/output requirements. 
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X Processors perform computations and provide documentation support for basic flight 
design and CFP development. They can be executed Individually or sequentially, In an 
Interactive or batch mode. The X Processor User Reference Manual contains detailed 
descriptions of all X Processors* 


The following Is a list of X Processors and associated ITs used In solving the 
example problem* 


8ASTM, T1 


Establish time reference to be used by all 
subsequent X Processors* 

PHYOM, HOWBIG 

— 

Establish physical dimensions to be used by 
all subsequent X Processors* 

ASCENT, UP 

— 

Perform launch computation. Establish state vector 
at Main Engine Cutoff (MECO). 

GPMP, ETSEP 

— 

Perform computation associated with external 
tank separation maneuver. 

GPMP, 0MS1 

— 

Simulate first OMS burn to achieve parking orbit 
altitude (150 nm.). 

GPMP, 0MS2 

— 

Simulate second OMS burn to circularize parking orbit. 

GPMP, SEP1 

— 

Deploy (separate from) first payload. 

GPMP, PKM 

— 

Simulate upper stage perigee kick maneuver to place first 
payload at geosynchronous altitude. 

GPMP, AKM 


Apogee kick maneuver to circularize geosynchronous orbit. 

GPMP, TRANS 

— 

Transition to 200 nm. shuttle orbit. 

GPMP, CIRC1 

— 

Circularize 200 nm. orbit. 

GPMP, SEP2 

— 

Deploy second payload. 

ACOAST, ORB 


Project state vector forward as If "coasting". 
Forward projection Is to allow detailed ephemerls 
computation. 

INVAR, EPHM 

— 

Compute smooth (detailed) ephemerls. 

STCN, G'JTDN 

— 

Determine ground station contact Intervals for 
communication. 

SRSS, SUN 

— 

Compute day/night cycle Information (Sunrise, Sunset). 

LANDOPT, LAND 

— 

Compute landing opportunities within crossrange 
capability of orb Iter. 

DEORBIT, DEORB 

— 

For the selected landing opportunity, perform 
detailed deorb It and landing computation. 

GTRACK, GTK 

— 

Compute ground track for entire mission. 

FPD, FLTP 

— 

Produce Flight Plan Dlsplay(s) for entire mission. 
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14 sequence, tables 


A Sequence Table contains a sequence of FDS commands ("statements") which have been 
stored for later execution. 


A. Sequence Table (ST) Is a named and formatted colle ction of FDS commands stored for 
subsequent execution. STs allow the user to define and store often-used sequences of 
commands. All or part of a Sequence Table may be executed as an entity In either 
automat lc r semi-automatic , or batch inodes of execution. Although STs normally contain 
commands that are executed sequentially, these commands can also be executed 
repetitively or conditionally. 


Sequence Tables may be created, altered, or deleted. STs created by the user are 
automatically stored In the AWA; however, the user may also store STs In PDBs, or 
retrieve master Sequence Tables from MDBs. There are no default STs. The user creates 
new STs "from scratch" or by editing existing STs. 


Each entry In an ST consists of an entry number and a comma nd (with Its associated 
parameters) . The entry number Is an unsigned Integer and appears In ascending numerical 
order (range: 1-32767). All of the Executive commands except OFF . CLEAR and EXIT may 

be used In Sequence Tables. In particular, DO LOOP . LOOP END . J£, ELSE , and ENDIF may 
be used on I y In Sequence Tables. Each command requires a specific order and format for 
any associated parameters. See later discussions of commands for proper syntax. 



RESULTING ACTION 

GET ..... SIZE-IT 
PERFORM, PHYDM, SIZE 


The user instructs the Executive to run a Sequence Table. 

The Executive then acts on the various commands within the ST. 

The initial ST may invoke other STs, or return control to the user 
through the Executive. 


14-1. Sequence Tables allow the user to store a series of commands for 
later execution. 
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Sequence Tables contain sequences of Executive commands. By storing a series of 
. , commands In an ST, the user Is able to execute the series simply by Invoking the ST. 

| ' The commands are ordinarily executed In simple serial order, but they can also be 

v Invoked repetitively, conditionally, or sequentially. STs are stored In AWAs, POBs, or 

retrieved from MDBs. There are no default STs. 


The normal approach to solving a basic flight design problem with FDS Is to 
construct a Sequence Table which executes. In turn, each of the required 
5 X Processors. The use of a stored "program" allows the user to correct errors 

- - and re-execute the computational sequence with minimal effort. It also provides 

a mechanism for remembering the computational process at any time In the future. 
The ST for the trajectory portion of the example problem closely follows the 
list of trajectory events presented previously. 


This ST provides the commands and associated data necessary to simulate the 
example mission through the GROUICTRACK CHECK event. The majority of the 
entries In this ST contain a 


PERFORM statement fol lowed by 
an X Processor name, and the 
name of an associated 
Interface Table. As one might 
guess, each of these commands 
causes one of the X Processors 
to be executed. The NOTE 
statement Is also used 
frequently (entry numbers 100, 
700, etc.). The NOTE 
statements are not executed by 
FDS, but are Input by the user 
for clarification purposes. 

The ALLOCATE statement Is also 
present In the ST (entry 
numbers 400-600). ALLOCATE 
allows the user to define 
certain Data Elements 
necessary for X Processor 
calculations. Entry numbers 
900 and 1400 contain ASSIGN 
statements. This statement 
allows the user to compute 
values and store them In an 
existing DE. Finally, the 
LIST statement Is used In the 
example ST. Entry number 2500 
Instructs FDS to display the 
contents of the Data Element 
called RESULT on the line 
printer (-P). 


SEQUENCE TABLE 


100, NOTE INITIALIZATION" 

200, PERFORM, BASTM,T1 
300, PERFORM, PH YDM.HOWBIG 
400, ALLOCATE, I NVEC ( 30 , 20 ) -R 
500, ALLOCATE, RESULT(30,20)-R 
600, ALLOCATE, HIALT(30,20)-R 
700, NOTE, "ASCENT" 

800, PERFORM, ASCENT, UP 
900, ASSIGN, RESULT(13,1) = 2.430089E+05 
1000, PERFORM, GPMP.ETSEP 
1100, PERFORM, GPMP.0MS1 
1200, PERFORM, GPMP,0MS2 
1300, NOTE "PAYLOAD 1" 

1400, ASSIGN, RESULT(13, 7) = - 1 . 254199E-KJ4 

1500, PERFORM, GPMP.SEP1 

1600, N0TE,"UPPERSTAGE PAYLOAD 1" 

1700, PERFORM, GPMP.PKM 
1800, PERFORM, GPMP, AKM 
1900, NOTE, "PAYLOAD 2" 

2000, PERFORM, GPMP, TRANS 

2100, PERFORM, GPMP, CIRC 1 

2200, ASSIGN, RESULT(13, 13) = -6.319999E+03 

2300, PERFORM, GPMP, SEP 2 

2400, NOTE, "DEORBIT CHECK AND DISPLAY" 

2500, LIST-P, RESULT 

2600, PERFORM .AC0AST, ORB 

2700, PERFORM .INVAR , E r Hf • 

2800, PERFORM, STCN.GSIDN 
2900, PERFORM, SRSS, SUN 
3000, PERFORM, LAND0PT, LAND 
3100, PERFORM, DEORBIT, DEORB 
3200, PERFORM, GTRACK.GTK 
3300, PERFORM, FPD.FLTP 
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15 FD.S -H A RD W ARE 


The FDS consists of four major hardware components. In addition to several user 
workstation devices for Interacting with FDS. 


The ..INTERDATA 6/32 Is the primary system ^for the 5D S. The Executlve_and X Processors 
reside on This system . This component Is the primary Interface between the user and the 
functions provided by FDS. The Tektronix terminals are directly connected to this 
component. Through these terminals, the user can access any of the functional 
components of the FDS. 


The XERO X YT-3 Jiford Processing System supports document production . This component 
functions as the center for automated documentation. Skeletal document forms reside on 
the Xerox and can be requested by the user through the Interdata. These skeletal 
documents are merged with data values and transmitted back to the Xerox for production. 



15-1. Each of the FDS hardware components has a unique use. 


IhS-HP21M£ .-Ls-usocLas.. .an-Later f ass th a t -s a s.s£s documen t - r_fi.UtetL.dat a betw ee n .the. 
Interdata and the Xerox . Although the HP21MX Is a separate computer system and could be 
used for a variety of purposes, this Is the only role It plays as a part of FDS. 


The UN1VAC..UQB J& tM -host computer fo r t h e . Y P r o cessors, jthlsh, provide t he. R .JE... 
capahl 1 1 ty_ of FQS . V Processors are used to generate h Igh-f Idel I ty OFP data. This 
hardware component of the FDS Is larger than the others and can compute results to a 
greater accuracy. This component can only be accessed In a remote job entry mode; It 
cannot be accessed Interactively from a terminal, although Inputs to and outputs from 
this component can be done via a terminal. Some outputs from V Processors, such as 
figures and graphs, cannot be transmitted back to the user terminal. However, all 
nongraphlcal data that are needed for further work with X Processors or for document 
production can be displayed at the terminal. 


MQst__al-the_lAteract 1 ons _wlt h_The_FD_S_ _are ±hrouQh__the terminal . Communications with the 
FDS are Initiated through a TEKTRONIX terminal which Is connected to the Interdata. All 
user commands are Initially Input through a terminal and most of the output from the FDS 
Is returned to the terminal. There are other devices, however, that also aid In using 
the FDS. 


For high-quality output of gr aphical data.. _a__p r I nter/p I otter Is available. The VERSATEK 
pr I nter/plotter Is one device that the user can access. This could be used, for 
example, to produce ground tracks. There Is only one such device and It must be shared 
by al I users. 
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The FDS consists of four major hardware components — an Interdata 8/32 
primary computer, an HP21MX minicomputer, a Xerox VT-3 Word Processing system, 
and a Unlvac 1108, The user workstation provides a variety of devices that 
allow the user to Interact with FDS for a variety of functions. 



15-2. FDS has several input/output devices. 


A hardcopy device Is associated with each terminal . The user may wish to have a copy of 
some of the Information that Is returned to the terminal. This device allows the user 
to generate a copy of the current contents of the terminal screen. If the user wants to 
save It. 


T h e . d ocument arocsss.. Lna aprk s l at Fori a-speclal -purpos e . .print e r. 

The terminals associated with the Xerox can only be used for final document production; 
they cannot be used to access other components of the FDS. Although using this device 
Is the only way In which documents may be printed, preparation for document production 
can be done through any FDS terminal. 


In solving the CFP portion of the example problem, primarily X Processors will 
be used. This Involves use of the Interdata 8/32 primary system. 


1 USER 


INTERDATA 8/32 


In order to access Y Processors, for example to solve the OFP portion, the 
Unlvac Is accessed through the Interdata and data are returned to the 
I nterdata. 


USER 

1— i 

INTERDATA 8/3 2 

— ► UNIVAC 1108 — ► 

INTERDATA 8/32 


In order to produce a document, such as an OFP or a CFP, the user Interacts 
with the Interdata, which creates a communication link with the Xerox via the 
HP21MX. 


USER 


INTERDATA 8/32 


HP21MX 


XEROX 
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16 FD.S-CQMMAND.S 


The F OS user communicates with the FDS system through a set of commands. 


fach of the oper at 1 on^erl-ormed bx fDi-l.s supported by FD-S. .commands. The command name 
entered at the terminal tells the FDS system to do the procedure or procedures Indicated 
by that command. Most command names are followed by a list of parameters, separated by 
commas. The parameters supply FDS with Information about how It Is to carry out the 
command, or what values or files are required. The FDS system Interprets each parameter 
according to a syntax which specifies the order In which the possible parameters are 
entered. For some commands, some of the parameters must be specified every time the 
command name Is entered. These are called required parameters. Other parameters can be 
omitted. In which case FDS assumes default values for those parameters. 


CommaadL .Ja-thfi-f-D-S- User Guide . w ill always, be ty ped In capital l e tters* When the syntax 
of the command Is described, the command name wilt be followed by the set of parameters 
associated with that command, separated by commas. Requ I red parameters of a command, 
which must be Included each time that command Is used, will be Indicated by unde r I Ines . 
Optional parameters will not be underlined. Ellipses (...) will be used to Indicate 
that a particular pattern can be repeated at will* An example of the format used for 
commands In this user guide Is shown below. 

COMMAND parameter 1 f parameter 2, parameter 3,..* 

This command takes three parameters, only the first of which Is required. 



16-1. Each of the operations performed by the FDS Executive is supported by 
a set of commands. 
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Each of the operations performed by FDS ts supported by one or more commands. 
The user communicates with FDS by using these commands. The basic form In 
which FDS commands are stated Is 

COMMAND . parameter 1 . parameter 2, parameter 3,... 

When FDS commands are described In the user guide, command names will be shown 
In capital letters and required parameters will be underlined. A command may 
be useable as a directive (which Is executed Immediately), or as a statement 
(which Is stored for later execution), or as either. 


Most FDS commands can either be executed.. Immediate! v or ca n — be Stored — Lo — fl -Sequence 
tabJa for later execution . When a command Is to be performed as soon as It Is entered 
by the user. It Is called a DIRECTIVE. When a command Is stored for later use — much 
like a statement In a programming language — It Is called a STATEMENT. Statements are 
stored In Sequence Tables, while directives are executed Immediately hy the FDS 
Executive. Although most commands can be used as either directives or statements, there 
are a few commands which can only be directives, and a few which can be only statements. 



16.2. FDS Directives are executed 16-3. FDS Statements are stored in sequence 
immediately by the Executive. tables for later execution. 

To perform the computations associated with the OMS-2 trajectory 
clrcul arlzatlon maneuver, the user uses the PERFORM command. The purpose of 
the PERFORM command Is to cause the execution of a single X Processor. The 
generic description of the command Is 

PERFORM. X Processor name . Interface table name 

For this particular computation, the desired processor Is the General Purpose 
Maneuver Processor, whose abbreviated system name Is GPMP. The Interface 
Table which was constructed for this maneuver was called 0MS2. Thus, the 
actual command will be 

PERFORM, GPMP, 0MS2 

This command can be stored as a statemen 1 In a sequence table, so that It Is 
executed at the appropriate point In a larger sequence of statements. If the 
user wanted to, though, he or she could type the same command when not editing 
a sequence table. In that event. It would be a DIRECTIVE and would be 
executed I mmed lately. 
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Successful operation of FDS requires a very basic knowledge of the terminal and Its jse 


4014 , This terminal has a very 
high-quality graphical display 
capability. Unless the user 
Indicates otherwise when signing on 
(see later discussion), FDS assumes 
that this terminal Is the type In 
use. Although the basic FDS 
dialogue does not make use of 
graphics, several of the 
X Processors prod .ce graphical 
displays If the user Is using a 
Teklron I x term Inal. 


terminals . After the terminal Is 
turned on (the switch Is on the 

pedestal, under the keyboard, on 1/-1. The Tektronix 401^ is the uas i c TD. uset 

the right). It must be allowed to terminal, 

warm up for a minute or two. The 

screen must then be cleared (by pressing the RESET/PAGE key at the upper left corner of 
the main keyboard) before Information can be displayed on It. This same key can be use 
as desired to clear the screen. It Is also recommended that the screen be cleared 
before the terminal Is turned off. If no Information Is Input or written to the 
terminal for a minute or so, the display Intensity Is automatically reduced In order to 
prolong the life of the CRT. The display can be reinstated by pressing the SHIFT key. 
For more detailed Information, the user should consult the User Manual for the terminal 


17-2. The Tektronix keyboard has special features because the terminal uses a 
storage-tube display. 
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Although many typos of usor terminals can potentially bo used with FOS, tho basic FOS 
terminal Is tho Tektronix 4014 graphical display terminal. It has som© special features 
which must b© understood for satisfactory use, ©spec Tally as regards display clearing. 
Other aspects of terminal use which the user should understand Include the RETURN key, 
command abbreviation and termination, and multiple-line commands. 
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RETURN key . This key (which Is abbreviated "(CR)", for carriage return) must be pressed 
before FDS can take any action. Thus, when typing In a command, the user must always 
press RETURN at the end, even though the command definitions do not Indicate this. 

RETURN is not actually a part of the command, but Is merely the system f s way of 
recognizing that the user has finished typing. 


Thus, the ABSTRACT command 
can be abbreviated AB, ABS, 
ABST, etc. Semicolons can 
also be used to terminate 
any command, although only a 
few commands actually 
require 4 hls. Blanks can be 
typed between arguments In a 
command, In or'er to Improve 
readabl I Ity. Otherwise, 
commands must be typed as 
Indicated In the Individual 
command descriptions 
presented In this user 
guide. 


The user should assuro the following switch settings: 

1. LOCAL/LINE Switch set to LINE. 

2. ASCII/ALT switch sot to ASCII. 

3. MARGIN CONTROL set to I. 

4. TTY LOCK dep rev j. 

After turning on t* , the user should depress ! , 

the escape key (ESC), followed by 9 or colon (:), to 
set tho character size. Allowable codes are: 

Escape, 8 60 characters per lino 

Escape, 9 80 characters per line 

Escape,: 120 characters per line 

Escape,: 132 characters per line 

7-3. For proper terminal operation, the user must assure 
correct switch settings. 


Ordinarily, this facility will be needed only If the command contains many arguments, or 
a long text string. The system will assume that the user Intends to continue typing 
whenever the user presses RETURN within a literal character string 
ABSTRACT, MYPDS,"TH IS IS (CR) 

C0NTINUE:MY ABSTRACTOR) 
or Immediately after a comma 
ABSTRACT, MYP0S,(CR) 

C0NTINUE:"TH I S IS MY ABSTRACT" (CR ) 

Notice that the system automatically prompts the user to continue by displaying 
CONTINUE: 

Such commands can be continued over several lines, as nocessary. 


Control-C Is abbreviated • In this user guide. This Is the character that Is generated 
when +he user presses the key for tne letter C while holding down the "CONTROL" key . 
This action, within a character string, causes the system to start a new line whenever 
this part of the text string is reached. Thus, the Input 
ABSTRACT,MYPOS, "TH I S IS # MY ABSTRACT" (CR ) 
causes the new abstract to be 
THIS IS 
MY ABSTRACT 
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18 


When the user signs on or off of the FOS, certain events occur automatically. 


Two events happen hoth whan the user signs 
on to the FDS and when the user signs off. 
At s'gn-on, communication Is established 
with the FDS Executive and an AWA Is 
assigned to the user. At sign-off, 
communication with the Executive Is 
terminated and the AWA Is purged. 


Only qualified users mav sign on to the 
FDS . Each user of the FDS Is assigned a 
two-character Identl f Icatlon code, called 
an ACCESS CODE. This code Is assigned by 
FOS support personnel and Is used to sign on to the FDS. The user may sign on through 
any terminal that Is displaying the FDS slgn-on prompt "FDS Slgn-on:". The access code 
ts also used to Identify the owner of a FDB. In order to access another user's PDBs, 
the corresponding access code must be known. 


During Sign-on, FDS: 

► Establishes user link with Executive 

► Establishes (empty) AWA 

During Sign-off, FDS 

► Purges AWA 

*■ Terminates user link with Executive 

18-1. Two events happen both when a user 
signs on and signs off of FDS. 


access code, data base name-class-access code, sequence table name, terminal type.DWA size 


18-2. The user signs on with an access code rather than with a command. 

The user can cause a sequence table to be automatically executed, .at _s.Lan.-on. At 
slgn-on, the user can name a sequence table and it will be executed automatically. This 
sequence table could, for example, cause desired files and data bases to be retrieved 
into the AWA, system messages to be printed, etc. The user specifies the ST by giving 
both the name of the data base (e.q., POO ) in which it resides and the name of the ST 
I tsel f . 


FDS Sign-on:UC 

FDS Sign-on:UC, IN JT-PD-0C,TAB1 


FDS Sign-on:UC,SET-MD,TAB3,,64 


FDS Sign-on:UC,, ,,64 


sign-on under access code "UC" 

sign-on and cause sequence table TAB1, 
stored in PDB INIT and belonging user "0C“ 
to be executed 

sign-on and cause TAB3 in MDB SET uc be 
executed and set DWA size to 64 sectors 

sign-on under access code UC and set DWA size 
to 64 sectors 


18-3. There are several ways in which to sign on. 

At slgn-on. the user may also specify the terminal tvoe and the, desired size the disk 
portion of the AWA . If no terminal type Is specified, the Tektronix 4014 Is jsr.med, 
and graphical displays may be presented on the terminal. The final argument ■:•••■ Ifles 
the maximum number of sectors to te o 1 located for the disk-resident portion of ‘he AWA 
(see below). This field Is an Integer In the range of 1-0192. The specified number 
will be rounded up to the nearest lA-sector block. If this argumerif Is omitted, 400 
sectors (25 16-sector blocks) Is assumed. 


36 




To sign on: 

access coda r data base name-class-access code, sequence table name, term Inal type, DWA size 
To sign off: 

OFF 

In order to use the FDS, users must first Mgn on. Signing on establishes 
communications with the FDS Executive and allocates an AWA for each user. These effects 
are reversed at sign-off. Only qualified users, who have been assigned an access code, 
may sign on to the FDS. 


The disk portion. AWA is, cal led the DISK WORK AREA (DWA) . The DWA Is an extension 

of the AWA. The AWA has a fixed size. Any overflows of data from the AWA are 
accommodated In the DWA, Except for DRDEs, which are always stored In the DWA, the user 
need not be concerned with whether a table, file, etc.&ls In the random access memory 
portion of the AWA or In the DWA; the FDS Executive automatically retrieves DWA data to 
the memory portion of the AWA when It Is needed. All DWA management functions and data 
transfers are accomplished 't+omatlcal I y by the FDS Executive, At slgn-on, the user 
need only specify the desi;?* size of the DWA, If different from the default value. 


Enter the directive OFF in response to Executive's % prompt 
% : OFF 

Then FDS will issue a sign-off warning prompt: 

*WARNING*EX*XDOFF*NNN* 

SIGN-OFF REQUESTED FOR USER ID, AWA TO BE PURGED 

RESPOND "YES" TO PURGE AWA SIGN-OFF, "NO" TO ABORT SIGN-OFF: (response) 


18-4. Signing off is done with the OFF command 


Signing off Is accomplished with the OFF directive . When the user enters this 
directive, FDS will Issue a prompt at the user's terminal, warning that the user's AWA 
will be purged unless action Is taken to save Information In the AWA. Any action to 
save AWA data must be taken before the sign-off Is completed. If data are to be 
retained, and have not previously been saved, the user may abcrt the sign-off procedure 
by responding "NO” to the prompt. This will terminate the sign-off procedure and 
re-establish communication with the Executive. A response of "YES" to the prompt will 
cause the sign-off procedure to be completed. 


When working on the example problem, assume that 
the Information that has been generated so far 
Is stored In a PDB called EXPL1 • A sequence 
table, for example INIT, could be constructed to 
cause EXPL1 to be loaded Into the AWA. Assuming 
that INIT Is stored In a PDB called SET, which 
belongs to user UC, INIT could be executed 
automatically by signing on In the following 
way: 

UC,$ET-PD-UC, INIT, ,800 

This particular slgn-on entry also requested 
that the DWA size be set to 800 sectors. 


INIT-ST 

100, GET,EXPL1-PD 
200, TOC 


37 



Certain conditions will cause FDS to generate a system message that may, or may not, 
require a user response. 


A. system message^ Initiated and generated bv FDS._Lnfonns the. user_Qi_some__CQfidJ_tJQiLQr 
occurrence ndthin the Executives ^ processor . A system message wl I I include a 
severity code, origin of the message, name of the program Issuing the message, a number 
Identifying the displayed message, and message text explaining the situation. The 
severity code will consist of either ERROR , which Indicates that a failure occurred, 
terminating the Immediate execution process, WARNING , which Informs the user that a 
problem nas been detected which may require action (at the user f s discretion), or INFQ , 
a system message that contains Instructional or guidance Information. The origin of 
these messages will either be the Executive or a particular processor. As a general 
rule, the user Is not required to respond to these types of messages. The user 
ordinarily will not make use of the program name and message number, but may use this 
Information in requesting a more detailed explanation of the error. 


By-J^yp Ing In the_Jdentit ier of an error message, followed bv_a Quest Jon, mark, the user 
can obtain a_ more deta! led explanation . If, for example, the message Is Identified with 
the characters (*ERROR*PR*GPMP*001*), the user can obtain more detailed information by 
typing the characters (*ERROR*PR*GPMP*001*? ) . 


*ERR0R*PR*GPMP*001* 

INPUT VECTOR IS NOT TEG/CARTESIAN 
$:*PR*GPMP*001 *? 

*#* MESSAGE PR*GPMP001 

INPUT VECTOR IS NOT TEG/CARTESIAN 

*** TUTORIAL 

MEANING: THE USER HAS INPUT A VECTOR THAT IS NOT IN THE TRUE EQUATOR AND 
GREENWICH MERIDIAN OF EPOCH CARTESIAN COORDINATE SYSTEM. 

ACTION REQUIRED: TRANSFORM THE VECTOR TO TEG/CARTESIAN 


19-1. After a system message, the user can request more information. 


Jf t here ls ..an abnormal prscssasr. te rmination labend?» the user Mill be nclJf is! by. FDS* 
In most cases, an abnormal processor termination Is caused by an error In the Input 
data. The user Is notified of the processor abend and recovery procedures will depend 
on the mode of operation. The PERFORM command which caused the processor to be executed 
may have been entered directly by the user, or It may be In a Sequence Table. In all 
cases, the PERFORM command Is terminated. If a ST Is being executed In the AUTOMATIC 
mode, execution of the entire ST Is also terminated. While In the SEMIAUTOMATIC mode, 
an error will cause the user to be reprompted with the same entry of the Sequence Table 
which caused the abend to occur. In the BATCH mode, an error will terminate the job and 
the user Is notified of the abend via the BATCH printed output. In any case, output 
data may be nonexistent, or only partially available, depending on where the abend 
occurred. The user Is responsible for examining the data and performing the necessary 
housekeeping functions to correct the error. 


If the user initiates a processor abort (abend). FDS wLLLaenerate a message requesting 

next action . When there Is no outstanding prompt on the user's terminal, the user can 
strike the break key to obtain the following message from FDS. 

* 1 NFO#EX#XMNTR#nnn» 

USER INITIATED INTERRUPT 

ENTER REQUEST - STATUS SUMMARY (SS), ABORT ($), OR CONTINUE (CR): 
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FDS generates systerr messages that expla'n certain conditions. ERROR, WARNING, or INFO 
messages describe ccndillons within the Executive or a processor. Mode of operation 
will determine FDS notification procedures during a processor abnormal termination 
(abend). User- Inlt I ated processor abend (using the "break" key) will result In a status 
summary display, abort of processor operation, or continuation of processor execution, 
at the option of the user. 


MODE 

DESCRIPTION 

Manual 

User executes one processor by typing PERFORM command. 

Semi automatic 

System executes Sequence Table, one statement at a time, 
as a result of SEMIAUTOMATIC command. User is given 
opportunity to alter or veto each statement before 
it Is executed. 

Automatic 

System executes entire Sequence Table as a result of 
AUTOMATIC command. There Is user interaction only If 
the processor requires information not provided by the 
Interface Table. 

Batch 

A Sequence Table is submitted, via the BATCH command, 
for later execution by the system. There is no 
Interaction with the user, who may not even be signed 
on at batch execution time. 


19-2. Mode of operation will affect error recovery. 


If the user responds with (SS), FDS will aisplay the functional status of all active 
tasks associated with the terminal. If a (CR) (carriage return) Is struck In response 
to the user initiated Interrupt, no action is taken and the processor continues to 
execute. When the (?) symbol is used, a second prompt is Issued to solicit concurrence 
to abort and to display information about the program name, stack position, and monitor 
Identification. The prompt Is: (task name) TO BE CANCELLED, REPLY YES TO CANCEL, NO TO 

ABORT CANCEL: A YES response will abnormally terminate the curren+'y active 

program. The user Is notified of the program termination and reprompted appropriately. 

A NO response causes the processor to continue to execute. 


there is an outstanding prompt on the user's terminal, and the user.. wishes_to abend 
the executing command or processor, the user merely enters the (?) s^bol . At that 
point, FDS notifies the user of the processor termination and the user Is reprompted 

appropriately. * 




BREAK KEY STATUS 

DISPLAY 


SYAB 

PROGMAWE 

OLDTAB-CIASS 

NEUTAB 

SEO I 

t 

XDEDIT 

- ST 

Z1 

eeeeee 

\ 

XDEDIT 

- IT 

21 

000000 

• 

XDXCTL 

T1 - ST 


000010 

t 

XDAltO 

- 


000000 


19-3. If (SS) is keyed during a user initiated interrupt, FDS will 
display a status summary. 


ii 
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2 0 


The editor Is used to construct new tables and alter old tables. 


The edi to r Is th at porlJan af. t he F D S . Exgcull. v .e that provides the .user with the 
capabilities to cre ate new t ables or modify existing tables . The user can edit 
Interface, sequence, linkage, and Y-data tables. 


With the editor, the user can: 

► create a new sequence or Y-data table 

► create a copy of a default linkage or interface table and modify it 

► create a copy of any existing table and modify it 

► modify an existing table 

► add new entries to any sequence or Y-data table 

► complete entries with incomplete or missing data fields 

► modify data fields within an entry 


20-1. The editor is used to create and/or modify tables. 

All editing is performed on_ a temporary copy of a table . The FDS editor creates a 
temporary, duplicate copy of a table being edited. Changes are made only to this 
temporary table. If the editing function Is aborted, no changes are made to the table 
being edited. If the editor Is terminated normally, then the modified table Is stored 
In the AWA, where It can remain for the duration of the terminal session. In order to 
make these changes permanent, the revised table must be copied to a PDB. 


Ihg.£fl l , t iJifl f unct lo n-can-te .Lny.Gked JnjalThe r cf-. t .vtc . w ay s t- e xpi i £.itl.y--Qr-impJ.icllU. 

The editor Is Invoked EXPLICITLY by use of the EDIT command. The user does this In 

order to create or modify a table and store It for later use. i 


Ihfi. .editor can b e IMPLICITLY Invoked. Jitigri t lie system .Is. a ttempting . to . use .a table. .that. . 

has Incomplete or missing Items . In this case, the system automatically Invokes the 
editor In order to allow the user to provide the required Information. When this 
occurs, the editor prompts the user to provide the specific Information that Is missing. 

A typical Implicit editor Invocation Is the situation In which an X Processor Is 

executed, and the Interface table has missing or Incomplete data. The editor Is Invoked 

because the data must be provided before the processor can continue, in the case of the * 

interface table, the user provides the missing data, and this Information Is relayed to 

the processor, but It is not stored In the Interface table. If the same table Is used 

again, the same missing or Incomplete values must be provided. 


Because tables differ In their 
content, a slightly jll.f ferente.ll.tl.ng 
capability Is provided fcr each type 
of table . The FDS editor Is divided 
Into four areas, each with Its own 
unique prompt symbol. Each area 
corresponds to a type of table and the 
editing operations that can be applied 
are a function of the type of table 
I nvol ved. 
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# - sequence table editing function 

\ - interface table editing function 
< - linkage table editing function 
> - Y-data table editing function 

20-2. There are four functional areas of 
the table editor. 




1 

A 


The EDIT command provides access to the FDS capabilities to create and modify tables. 
This command Invokes a table editor, whose behavior differs depending on the type of 
file (classification code) being edited. 

ED IT, current table name, new table name-classification code . ref erence name 
The EXIT command causes a normal termination of an editing operation. Including storage 
of the modified file. An editing operation can be aborted by typing the t character. 
EXIT 



Marina 1 ly. . t he-.ed.LtQr Js -terminated. by. 


20-3. 


The syntax of the EXIT 
command. 


typ 1 no . 1 n t he. JEXlX-csmmand . exit is a 
directive only, and cannot meaningfully be 
stored In a sequence table. When the user 
types EXIT, the modified table Is stored In 
the AWA (If the editor wes Implicitly 
Invoked). Of course, the table must be 
copied to a PDB If the user wishes to save 
It beyond the current terminal session. 


Ihe editor ca n also P.a_flbor te .k wi t hout saving .a ny re sults of t he. 1 1 1 ng. operation. 
The user does this by typing the % character. This character Is the normal prompt 
symbol for the Executive. By typing It while In the editor, the user Is asking for an 
Immediate return to the condition which existed before the editor was Invoked. No 
Information Is saved from the editing operation, and the table being edited remains 
unchanged. The user can do this even If the editor was Implicitly Invoked. 


EDIT, current table name, new table name-classification code reference name 


20-4. The syntax of the EDIT command. 


The EDIT command must name a TLnew tab I e 11 . and jnay also name a Current table 1 ' and a 
f, ref erence name” . The NEW TABLE name specifies where the table being edited will be 
stored when the editor Is EX I Ted. The CURRENT TABLE name Indicates the table to which 
modifications will be made. The REFERENCE NAME Is used to Indicate the X Processor for 
which a new Interface table Is being constructed or the document/segment associated with 
a linkage table. If the current name Is omitted, then a new table will be created. If 
both the current table name and new table name are specified, then changes made to the 
contents of the current table will be stored under the new table name. If the current 
table name and new table name are the same, then modifications are actually made to the 
current table. 


Command 

Effect j 

EDIT, ,NEW-ST (create) 

EDIT, ,NEW-IT,PR0CA (create) 

I EDIT, OLD, NEW-IT (copy and modify) 
EDIT.TAEl .TABl-ST (modify) 

EDIT -*> NEW TABLE 
DEFAULT IT =*> EDIT ■* NEW IT 

OLD TABLE =*> EDIT =*> NEW TABLE 

CURRENT TABLE =*> EDIT =*> MODIFIED CURRENT TABLE 


0-5. There are four ways to use the EDIT comnand. 
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21 Using the Editor. MODE Command 


The editor Interacts with the user In one of several modes, depending upon the type of 
table being edited and what the user wants to do with that table. 


The FDS Editor can operate in any of five modes . The CREATE mode is used to create a 
new sequence or Y-data table. These are the only types of tables that the user can 
create directly. Interface and linkage tables can be created only by modifying an 
existing table. This Is done by using the UPDATE mode. The update mode Is used to 
Insert new table entries and modify existing table entries. It Is the only editing mode 
In which directives to the FDS Executive can be given. For example, deleting an entry, 
with the DELETE command, can only be done In this mode. The INCOMPLETE mode causes the 
editor to read through the file, looking only for instances of incomplete data. Each of 
these Incomplete entries Is displayed, and the user Is prompted to provide the needed 
Inf cmatfon. The user can provide the data or skip to the next parameter for which no 
value present In the table. The MISSING mode behaves the same way, but cycles 
through cil Instances of optional data which are missing from the table. The missing 
mode* car be used only with I terface tables and linkage tables, since these are the only 
taole types which can have "optional" parameters. The ALL mode starts at tho top of a 
table and displays each entry In turn. In addition to a simple display of every line, 
th9 user Is prompted and allowed to edit any entries that are either Incomplete or 
missing. 


MODE 

PURPOSE 

Can be Used With 

IT 

LT 

ST 

YDT 

CREATE 

Create new table 

No 

No 

Yes 

Yes 

UPDATE 

Modify table entries 
(Executive directives allowed) 

Yes 

Yes 

Yes 

Yes 

INCOMPLETE 

Find and edit 

parameters which are incomplete 

Yes 

Yes 

Yes 

Yes 

MISSING 

Find and edit optional 
parameters which are missing 

Yes 

Yes 

j 

l — _ . | 

No 

No 

ALL 

Scan and edit entire table, 
one entry at a time 

Yes 

Yes 

Yes 

Yes 


21-1. The editor operates in any of several rr.odps. 


The modfi, r r,egulred..t.Q. create a nett t abl e d e pe nds on t he tabls-typs. a new sequence or 
Y-data table can be created either by editing an existing table or actually creating a 
new table. For these two types of tables, therefore, the user may either Initialize the 
editor with an existing table or directly enter the create mode. Interface and linkage 
tables can only be created by editing an existing table or the corresponding default 
tab I e. 
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The FDS Editor will be Initialized In one of several modes, depending on the 
type of table being edited and the status of that table. Each mode Is used to 
perform different editing tasks. The MODE command allows the user to select a 
desired mode. 


Die manner -iii-whlch...t.a^l^jen tries, are. re-ferenced. is ■ de .t. e rmJufil -the fo rm .of the tapis 
eri.tr 1 es . Sequence and Y-data table entries consist of commands ("statements" ) and 
character strings, respectively. For each entry, the user must supply an entry number, 
and individual entries are referenced, or accessed, by this number. Although entries in 
Interface and linkage tables are also numbered, the user cannot alter these numbers. 
Entries In these tables consist of parameter keywords and parameter values and they are 
referenced by the parameter keywords. 


Depending on the state of the table being. 
edltad, t he e ditor .jail 1 1 I nitial lyJte, 
Inyohed-iii one at threa modes* if a table 
has no Incomplete or missing entries, then 
the update mode will be used. If a table 
has Incomplete entries, then the Incomplete 
mode will be used. The create mode will be 
Invoked only If the user Is creating a new 
sequence or Y-data table. 


Die M ODE command al.low s t he user to select. 
an editing mode . When an editor Is 
explicitly Invoked, It wj I 1 be In either 
the update. Incomplete, or create mode. 

The update mode Is, In a sense, the basic 
mode of the editor. It Is, for example, 
the only mode In which FDS Executive 
directives can be typed In by the user, for 
Immediate execution. When the editor Is 
not In the update mode, the user can switch 
to the update mode by typing the prompt 
character associated with the particular 
type of table being edited. Once In the 
update mode, the user can. If desired, 
select another mode by using the MODE 
command. 


In a previous module ("DETAILED CONTENTS OF INTERFACE TABLES") a sample 
Interface table for the GPMP processor was presented. That IT was called 0MS2. 
and was Incomplete. Thus, the command 
EDIT, 0MS2, 0MS2-IT 

causes the editor to be Invoked In the INCOMPLETE mode, and the editor generates 
the prompt 

\260,GEOPOTFN*-: 

This prompt asks the user to provide a value for the parameter GEOPOTEN. 
Ordinarily, the value will be the name of a data element which defines the 
mathematical properties of the geopotential model to be used by GPMP. 

Once the user types In this value, the IT Is complete, since all other required 
values have already been provided. The editor then reverts automatically to the 
UPDATE mode, presenting the prompt 

The user can now type EXIT, or do any other desired editing operations. 


MODE, descriptor 


A - All 

MODE, A 

C -- Create 

MODE.C 

I -- Incomplete 

MODE, I 

M -- Missing 

MODE ,M 


21-3. After the editor has been 
invoked, the MODE command can be 
used to select a desired mode. 


# 

Sequence table 

\ 

Interface table 

; < 

Linkage Table 

> 

Y-Data table 


21-2. The user types a prompt 
character to switch to the 
update mode. 
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22 BASIC EDITOR DIRECTIVES AND RESPONSES 


Within the editor, there are several responses that can be used to obtain help or to 
perform common operations, regardless of the type of table being edited. 


Each of the editor moles > except. .for t he. -"ail 11 m ode., h as a mime .syntax, and .ILfferent 
user responses are allowed . When an editor Is ready for a user response, certain 
Information Is displayed to the user. This Information differs as d function of mode, 
as do the responses that will be accepted. The "all" mode uses the syntax of the 
"update" mode If an entry Is complete and that of the "Incomplete" mode If an entry has 
Incomplete fields. 


RESPONSE 

OPERATION 

carriage return 

skip to "next" entry 

% 

abort and return to previous condition 

7 

display list of statements, directives, or parameter keywords 

directive 

execute named FDS Executive directive 

directive? 

display syntax of named FDS Executive directive 

& 

incomplete item indicator 

&LABEL 

labeled incomplete item indicator 


22-1. Some user responses are cormon to the editing of all table types. 


A CARRIAGE RETURN, used by ItseJl, I s a-d.l£ac.ti ^ . e -that.jcau5a5..an editor t o. ..skip, .to. t he 
next entry . The "next entry", however, depends on the mode that the editor Is currently 
In. In the "all" mode, a carriage return causes a skip to the next entry. In the 
"missing" and "Incomplete" modes, a carriage return causes the editor to display the 
next missing entry or the next entry with Incomplete data fields. In the "update" and 
"create" modes, a carriage return has no effect. 


Cfirla In special symbols, .can be I nput £y...th.e . u ser t o. afrart.tM.edlTQr..,..Qr . t o. re turn t o.. 

the update mode . The user can always abort the editor and return to the prior condition 
by entering the % symbol. To get Into the update mode, the user types the special 
symbol corresondlng to the type of table being edited. 


3M_?. -S.ymbo.] Ls u sed to obtal a. .Iji for m at Io n . a bout, . t he ra sponsas. -which, t he user can 
"legally" make In the current situation . If the editor Is In the Incomplete mode or the 
missing mode, the user has been prompted with a request for specific Information (e.g., 
the value which Is to be associated with a keyword. In this situation, the ? can be 
used to obtain an "extended prompt" which provides additional Information about the 
Incomplete or missing item (e.g., the definition of the Interface table parameter whose 
value Is missing). On the other hand, a ? In the update mode causes the system to list 
all FDS directives and. In some cases, additional helpful Informal Ion. 
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Al Though the FDS Editor has somewhat different behavior for each type of fable, some 
user responses can be used regardless of the type of table belr.g edited. These 
responses can be used to obtain help or *io perform common operations. 


Aa fPS.SQmmarul t hat 1,5 to be acted on 
Immediately Is a "directive" . Such 
directives can only be used In the 
update mode (or, of course, outside 
the editor altogether). If the 
directive that Is named Is not valid, 
no action Is taken. Otherwise, the 
•-equested directive Is executed. The 
syntax of any valid directive can be 
displayed by typing the name of the 
directive, followed by a question 
mark. 


The & specifies that a data Item Is to be left Incomplete . The & can be typed as part 
of an original entry, or can be given as a response to a prompt In the Incomplete, 
missing, or all modes. The ampersand Is actually stored as part of the table, and Is 
the signal to FDS that this entry Is Incomplete. A given entry may have multiple 
Incomplete values. In this case, the editor automatically assigns a sequence number to 
the Incomplete Item for display purposes. For example, an Input of: 

1 0 , L I ST, & , TAB3-ST, & , TAB4- I T 

would be displayed with unique sequence numbers after the ampersands, as: 
10,LIST,&1,TAB3-ST,&2,TAB4-IT 

The &LABEL "placeholder” Is like the &, but a label of up to 7 alphanumeric characters 
has been added to aid the user In Identifying what Is left Incomplete. When the label 
Is used, Incomplete Items are not numbered by the editor. 


/i 

i < 

<«» 

* v 

carrioQ* return 


1 X T X A f 

l 

X 

X X X X 

? 

X 

x I x ! x x 

revert to update 


X X 1 X X 

dl recti ve 

1 

I I 

directive? 

X 

1 

k 


1 X ‘ X X XI 

MABEL 


, * x x xi 

LIST 

X 


DELETE 

< 


EXT 

X 



22-2. Editor responses can only be 
used in certain modes. 




* 





LIST, (first entry number - last entry number) 
DELETE, (first entry number - last entry number) 
Examples: 

LIST, (10-40) 

DELETE, (30-30) 


H 


22-3. When used as directives in the update mode, the LIST and 
DELETE commands can be used in simplified form. 


The LIST and DELETE directives can be used within an editor . These directives can be 
used to list or delete all or part of the table being edited. These functions can also 

be used as FDS Executive commands and the syntax that Is used In the editor differs from 

that used outside the editor. Within the editor, the user specifies the range of lines 

to be listed or deleted. Typing only LIST, with no parameters, will cause the entire 

table to be 1 Isted. 
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?3 IMIEBEACf, TABLE ED.1I1NG 


The nature of Interface tables determines some of the actions the user can take during 
IT editing. 


The structure of an Interface table Is determined bv the I nput/outimt requirements of, 
the X Processor which will use It , The IT structure Is determined by FDS support 
personnel, and cannot be changed by the user. Thus, keywords and entry numbers are 
fixed. The unly actions available to the user are those associated with adding, 
deleting, or changing values associated with the keywords. 


To Lnsure that all tables have the correct structure^ new tables can -be created Qfilv..b^ 
editing existing tables . Thus, the create mode does not exist for IT editing. The user 
can create a new table by modifying an exlslng one, changing only those values which are 
not already correct. Alternatively, the user can start with the default table (by 
providing no "existing table name" in the EDIT command). In this case, all values not 
present in the default table must be provided by the user. 


1 


MODE 

USE 

UPDATE 

i INCOMPLETE 
ALL 

MISSING 

edit, list, change, etc., with Executive directives 
view and change incomplete entries 
view each entry from start of table 
view and change missing entries 


23-1. Interface table editing can be done in any of four modes. 


Ihe-aay-.LT. which F DE prompts t he ui.gr depends on j.liejiiod£ aim .the ^L-£aTx^ . 

When the editor Is Initially Invoked, It starts In the INCOMPLETE mode, giving the user 
a chance to complete any Incomplete entries. (Of course. If there are no Incomplete 
entries, the editor automatical 1 y switches to the update mode.) Each Incomplete entry 
generates a prompt which shows the entire Incomplete entry and gives the user an 
opportunity to specify one or more missing values. The user Is prompted for each 
succeeding nonexistent value of the entry, until all such values have been addressed: 

10, A=1 ,&ABLE,&1 ,4 

\&ABLE:2 

\&1:3 

In this example, the user has provided the values 2 and 3, respectively, for the 
nonexistent values. A similar prompt Is provided In Ihe ALL mode whenever an Incomplete 
entry Is encountered. A slightly abbreviated prompt Is provided In the MISSING mode, 
since It Is known that no value field yet exists. This prompt shows the entry number, 
parameter name, and the equivalence symbol which shows whether the entry Is an Input 
(=), output (0), or Input/output (=0) parameter: 

40, M0DEL=: I IMODNAME 

In this example, the user has typed the value 1 IMODNAME after the prompt. In the UPDATE 
mode, the prompt consists simply of the IT editor cymbol : 

\: 
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The Interface table editing function Is used to croate new Interface tables from default 
or other existing tables, and to modify existing Interface tables. 


Hie, user may-j.espflnd-tQ IT editor orjornpla-iil tlL-a subscr i pt and . v alue. For example, if 
the parameter INVALS Is an array, the user can enter values Into Its third and fourth 
elements by responding 

40, INVALS®: (3)7., 8. 

This Input causes I NVAL S( 3 ) to have the value 7.0, and INVALSM) to have the value 8.0. 


Ec,r cases .In uhlch Ills user mu at, prayi-de a-.lls.l.Qf values, which has slpnlf leant 
repetition. FDS provides a "shorthand" method of, ..Inputting the values . The REPEAT LIST 
allows the value or group of values to be typed only once, with a repetition factor 
which Indicates how many times It Is to be repeated. Thus, the Input 20R5 Is equivalent 
to typing twenty separate values, each consisting of the number five. If more than one 
value appears In the repeat list, the list must be enclosed In parentheses, as In 
20R (1,2,3). These expressions can even be nested to a depth of four or less, as In 
20R(1,2R5). No subscripts may appear within a repeat list. A repeat list may contain 
only literal values or Incomplete Indicators (&)• If a table entry requires or Is 
provided with reference to a DE, DRDE, or Linkage Table, only one such reference Is 
needed and a repeat I 1st cannot be used. 


"REPEAT LIST" FORM 

EQUIVALENT 

4R5 

5, 5, 5, 5 

1.2R2.3R3 

1,2, 2, 3, 3. 3 

3R(5,7,"AB") 

5,7,"AB" ,5,7,"AB" ,5,7,"AB" 

2R(2R3,"XY") 

3,3,"XY" ,3,3,"XY" 


23-2. The repeat list can be used to repeat a list a values. 
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24 AN EXAMPLE QF INTERFACE TABLE. EDITING 


The preparation of the Interface table for the OMS-2 circularization maneuver provides a 
good, fairly typical example of IT editing. 


A previous module, "DETAILED CONTENTS OF INTERFACE TABLES", presented the OMS-2 IT as an 
example. This module will discuss the use of the editor to construct that IT. Assuming 
that the user starts with the default Interface table for GPMP, rather Than an existing 
IT, the command which starts the editing process Is 

t : ED I T , , 0MS2- 1 T , GPMP 

Because there are required parameters, for this Interface table, which do not have 
default values, the table Is Incomplete. Therefore, the editor starts In the Incomplete 
mode, giving the user a chance to provide values for these parameters. 

60,PR0CON=41 ,42,43,44 

\41 : 10 

\42:1.0E-4 

\43:6.0/E-4 

\44:75. 

In the case of PR0C0N, the user provides four GPMP tolerance values to be used In the 
computation. Similarly, the user provides values for other required parameters 

70, INVEC-41 
\41 : RESULT C 1 ,3) 

80, THRUST-41 
\41 s 1 .2E+04 
90, ISP=41 
\ 4 1 :3.131999E+02 
100,ENGID=41 
\41:"0MS" 

110, KAN ID-41 
\41:"CIRC" 

270,SVPROP=41 
\ 4 1 1 

Whenever the user needs additional Information about the parameter, the ? character can 
bo used. 

270,SVPROP=41 

\41-:7 

STATE VECTOR PROPAGATOR SELECTION FLAG 
"CON"-CONIC,"AEG"=ANALYTIC EPHEMERIS GENERATOR 
\ 4 1 :"AEG" 

290,GPMPTET(*41 

\4’:RESULT(1,3) 

300,SUMTAB641 
\ 41 : ICIRTAB 
\: 

The editor switches to the update mode when all required parameters have been provided. 
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Interface table editing It Illustrated by construction of the IT for the 0MS-? 
circular Izatlon maneuver. 


It would be easy 1o assume that the Interface table Is now finished. Ihat Is not the 
case, however. Values have been provided for all parameters which are required” but 
this Includes only those parameters which are always needed by n e X Pro:essor In 
question. In this particular case, there are also some optional p.,. ameters for which 
values will be needed because of the particular wav the user Is anal v lag .the .processor 
this time . In this particular case, most of the optional parameters are needed because 
the "CIRC" maneuver option was selected. At this point, the user has two basic options. 
One Is to wait and provide the values during actual execution — each time the processor 
needs a value not provided In the table, the editor will be Invoked automatically. The 
othor Is to provide the values now, before processor execution. To do this, the user 
might use the MODE command to get Into the MISSING mode. 

\:MODE,M 

The system will then step through the optional parameters which are missing f r om the IT, 
eventually reaching those of Interest to the user In this case. 

\ 24C ,DENSMODL* : I IDENSMD 
\ 250, SOL AF LUX*: ! ! SOLRMD 
\260,GEOPOTEN=: ? 

GEOPOTENTIAL MODEL 
\ 260 ,GE0P0TEN* : & 1 
\: 


With the exception that the user has Intentionally deferred the definition of an Input 
date element defining the geopotentlal model, the IT Is now complete. It can be kept 
(In the AWA) simply by a normal exit from the editor 

\ : EX I T 

t: 


The table Is now available for actual use by the GPMP processor. 
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Because sequence tables are the only tables that can contain Executive commands, some 
unique ST editing capabilities are provided. 


The may I n jthl&h fD.£ promt s the u s er depen ds e n - lhe made a nd the . -a t a te af .- tn e^S T entry • 
When the editor Is Invoked with the name of an existing sequence table. It starts In the 
INCOMPLETE mode, giving the user a chance to complete any Incomplete entries. (Of 
course. If there are no Incomplete entries, the editor automatical ly switches to the 
update mode.) Each Incomplete entry generates a prompt which shows the entire 
Incomplete entry and gives the user an opportunity to specify one missing value. The 
user Is prompted for each succeeding nonexistent value of the entry, until all such 
values have been addressed: 

1 20 , PERFORM, GPMP, 4 1 TNAME 

#& I TNAME :0MS2 

In this example, the user has provided the name (0MS2) of the Interface table which If 
to be used In connection with one execution of the GPMP processor. A similar prompt Is 
provided In the ALL mode whenever an Incomplete entry If encountered. Whene/er the user 
substitutes Information for a placeholder, the substltu/ed Information Is checked to see 
that It follows the syntax rules for the particular statement. In the UPDATE mode, the 
prompt consists simply of the ST editor symbol: 

#: 


MODE 

USE 

UPDATE 

CREATE 

INCOMPLETE 

ALL 

edit, list, change, etc. with Executive directives 
create new tables, add entries at end of existing table 
view and change incomplete entries 
view each entry from start of table 


25-1. Sequence Table editing can be done in any of four modes. 


When the editor Is Invoked without naming an existing ST. It starts In tlie .CREATE mods . 
This mode can also be entered via the mode command, of course. In the create mode, the 

editor allows the user to add new statements at the end of the table. The editor 

[ automatically generates the entry numbers, and the user need only type the statement 

Itsel f : 

' #110, : PERFORM, GPMP, 0MS1 

; #120,: PERFORM, GPMP , & I TNAME 

In this example, the user has typed In commands which will later cause the execution of 
the GPMP processor for both OMS-1 and OMS-2 burns. The naming of the Interface table 

for the OMS-2 burn has been deferred by the user. 

In the UPDATE mode, the user can obtain simple tutorial Information ghaut the 
| which may appear In a sequence table . By typing a question mark (?) character, the user 

can obtain a list of legal ST statements. These statements Include all Executive 
I directives except CLEAR and OFF, and also Include DO LOOP, LOOP END, IF and ELSE. By 

typing a statement keyword followed by a question mark (e.g., STORF?), the user can 

obtain Information about the syntax o 4 a particular statement. 
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The sequence table editing function Is used to create new sequence tables, and to modify 
existing STs. Sequence tables are the only table type that can contain commands to the 
Executive. The NUMBER directive can be used to renumber the table which Is being 
edited. 

NUMBER 

The NOTE statement allows the user to store textual comments within STs. 

NOTE , M text” 


Two FDS commands are especially associated with sequence tables and their editing . The 
NUMBER directive allows the FDS user to renumber the entries In a sequence table or 
Y-data table which Is being edited. The entries retain their original order, but are 
renumbered, beginning with 10 and Incrementing by 10 for each subsequent entry. The 
NUMBER directive can be executed only when the editor Is In the update mode. 


NUMBER 


25-2. Syntax of the NUMBER directive. 


Ihfi~NQTE statement, a I L qws t Le F DS user to add comments to sequence tables . These 
comments are not executed, but are used for clarifying the purpose of the sequence table 
or to provide tutorial Information. For example, the ST might be divided Into segments, 
each I dent I fed by a NOTE: 

110, NOTE, "THE FOLLOWING STATEMENTS ESTABLISH A 200 NM. ORBIT" 

NOTE statements are simply stored In the table like any other statements. They are 
always displayed when an ST Is listed or executed In the SEMIAUTOMATIC mode. When a ST 
Is executed In the AUTOMATIC or BATCH mode, the comments are displayed only If the 
appropriate trace option Is specified. The text portion of the comment Is bracketed by 
quotation marks ("), and may be up to 1600 characters long (counting control -C 
characters) . 


NOTE, "text" 


25-3. Syntax of the NOTE statement. 
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26 AN EXAMPLE QF SEQUENCE JABLE EDIT IMG 


The preparation of the basic sequence table for trajectory planning of the example 
problem provides a good, fairly typical example of ST editing. 


A previous module, "SEQUENCE TABLES", presented a trajectory planning ST as an example. 
This module will discuss the use of the editor to construct that ST. Assuming that the 
user starts from scratch, rather than with an existing ST, the command which starts the 
editing process Is 

*:EDi l,,EXP1-ST 

Since no old table name Is given In this command, the editor starts In the CREATE mode. 
In this mode, the editor generates the entry numbers and prompts the user for the 
contents of each entry. 

#10, :N0TE, "INITIALIZATION" 

#20, .-PERFORM, BASTM,T1 
#30, : PERFORM, PHYDM,HOWB I G 
#40 , : ALLOCATE , I N VEC ( 30 , 20 ) -R 
#50, : ALLOCATE, RESULT (30,20 )-R 
#60, : ALLOCATE, HI ALT (30, 20 )-R 
#70,: NOTE, "ASCENT" 

#80 , : PERFORM , ASCENT, & I TN AME 

Note that the user has deferred the decision concerning the IT name for the ASCENT 
processor. 


By using the ? character, the user can obtain helpful Information. For example, the 
response 


#90,:? 

will cause FDS to list all the statements which can appear In a sequence table, while 
the response 

#90,: ASSIGN? 

allows the user to obtain Information about the syntax of a particular statement (In 
this case, ASSIGN). When the Initial Input of the sequence table has been completed, 
the user can Input the ST editor symbol to change to the UPDATE mode. 

#320, : PERFORM, GTRACK,GTK 
#330,: PERFORM, FPD,FLTP 
#340,:# 

#: 


Now the table can be LISTed and edited further using CHANGE, INSERT, and other commands 
discussed later. If the user changes to the INCOMPLETE mode at this time, FDS will 
provide prompts for any Information which the user deferred. 

#:M0DE, I 

80 , PERFORM, ASCENT, & I TNAME 
#& ITNAME :UP 
#: 


Alternatively, the user might store the table In this Incomplete form, In which case the 
editor would automatically start In the INCOMPLETE mode In any subsequent editing 
session. 
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Sequence table editing Is illustrated by constructs of a basic sequence table for the 
trajectory design portion of the example problem. 


When the editing session Is finished, the user can EXIT normally, 

#:EXIT 

%: 

In which case the generated table will be stored In the AWA under the name EXP1. 
Alternatively, the editing results can be thrown away by entering the Executive prompt 
symbol ($). 

%: 

In this case, the edited table (EXP1-ST) Is deleted . Care must be used In aborting the 
editor In this way. In order to avoid Inadvertent deletion of needed Information. 


1 
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27 ABSTRACT Command (Creat.Lruu R ej lacing, and Displ a ying Abstracts) 


The ABSTRACT command displays the date/time tag and an abstract for any specified table, 
DE, DRDE, data base, YOD, document/segment, Xjob, Yjob, or processor, and a I lows the 
user to create or replace abstracts for personally owned files, data bases, etc. 


The ABSTRACT command can be used to learn what Information is present In tables^ til 
or data bases without viewing all of the Information . An abstract is a textual 
description of the contents of an OBJECT. Included with the abstract Is Information on 
the date and time the object was last changed and the creator of the table, file, data 
base, or processor. The user can add a new abstract where none exists or replace an 
existing abstract for personally owned objects or for another user’s PDB, if the user 
has access to It. MDBs, X and Y Processors, and document/segments have abstracts that 
are maintained by FDS support personnel. These abstracts can be displayed, but not 
mod If led. 


ABSTRACT-device code. ob iect . "text of abstract" 


27-1. Syntax of the ABSTRACT command. 


OBJECT I s . a n. . a rgument, used In .some, .cammands t a rafarance a f lla*. data base, ta ble 
processor . The OBJECT consists of an OBJECT NAME, a DATA CLASSIFICATION CODE, and. In 
some cases, an ACCESS CODE. The object name Is the name of the file or data base to be 
processed while the data classification code Indicates the file or data base type. If 
the object is a PDB belonging to another user, that user’s access code must also be 
provided. The access code Is a two-character code; an access code Is assigned to each 
FDS user. 


Abstracts can be added, replaced 

, or displayed for these 

data items 

table name-class 

TAB1-IT 


data element name-DE 

STAT-DE 


DRDE name-DF 

DSK-DF 


PDB name- PL 

PB0B6-PD 


YOD file name-YJ 

YDAT1-YJ 


, X Job name-XJ 

XDAT1-XJ 


Abstracts can only be displayed 

for these data items 


MDB name-MD 

! ! GLOCON-MD 


X Processor name-XP 

XPYES-XP 


Y Processor name-YP 

MNSTR-YP 


document/segment name-DS 

CFPTRJ-DS 


To display the abstract for another user’s PDB, use that 

user’s access code 

PDB name-PD-access code 

FILE1-PD-UC 



27-2. The OBJECT field is used to indicate a file, data base, or processor. 
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An abstract can be associated with all tables, files, data bases, and processors. 
The abstract Is a brief, textual description of the contents of a data Item. By 
adding abstracts to each data Item that Is created, users will be able to Identify 
the contents of that Item more readily. The ABSTRACT command Is used to create, 
replace, and display abstracts. 

ABSTRACT-dev Ice code. ob feet »”text of abstract” 


_ 

ST 

sequence table 

- 

IT 

interface table 

- 

LT 

linkage table 

j 

YT 

Y-data table 

- 

DE 

data element 

- 

DF 

DRDE 

- 

PD 

personal data base 

- 

MD 

master data base 

- 

YJ 

YOD or Y-job 

- 

XJ 

X-job 

- 

XP 

X processor 

- 

YP 

Y processor 

1 - 

DS 

document /segment 


27-3. DATA CLASSIFICATION CODES indicate 
the type of data to be processed. 


Ihe_DEYICE^ 1D_ Is used -to designate the output 
device for display purposes . Output from the 
ABSTRACT, and other commands, can be displayed 
either at the user’s terminal or on the system 
line printer. If no device Identifier Is 
specified, the line printer Is assumed for the 
BATCH mode and the terminal Is assumed for 
Interactive sessions. 


Ihe. "TEXT QF THE ABSTRACT” is a character string 
of up to 256 characters . It must be enclosed In 
quotation marks (” ). If the abstract to be 
entered requires more than one line of Input, 
entering a carriage return will cause the prompt 
CONTINUE: to appear, and the user can continue 

entering the text. The text Is terminated with 
a quotation mark (”). Typing Control-C within 
the text causes a new line In the displayed 
abstract. 




To display the abstract for an interface table (without update): 
ABSTRACT, TAB1-IT 

To display the abstract for another user’s PDB: 

j ABSTRACT, PDB1-PD-KP 

To replace and then display the abstract for a data element: 

ABSTRACT, EVENTS-DE, "TRAJECTORY EVENTS THROUGH OMS-2" 
27-4. Examples of use of the ABSTRACT command. 


One cf the uses of the ABSTRACT command Is to obtain Information about 
processors and MDBs provided by the system. In the example problem, one of the 
X Processors that will be used Is GPMP. In order to display the abstract for 
this processor, the command Is: 

ABSTRACT, GPM P-XP 

and the resulting display provides basic Information about the nature and use of 
this X Processor. 

The second major purpose of ABSTRACT Is to allow the user to add Information to 
a file which describes Its nature and use. For the example problem, the user 
might create a sequence table called EXPL1 and add an abstract that Identifies 
It as being related to the example problem. In this case, this command may be 
used: 

JS: ABSTRACT, EXPL1 -ST, "THIS TABLE CONTAINS A SEQUENCE OF COMMANDS (CR) 

CONTI NUE:THAT SOLVES THE • CFP PORTION OF THE EXAMPLE PROBLEM (CR) 

CONTINUE: IN THE FDS USER’S GUIDE.” 
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The LIST command Is used to display the contents of tables and files. 


LIST-device ID, object name (span) -file type. 


28-1. Syntax of the LIST command. 


The LIST .command .aUaws .the fD.iLuser to display iiie. .contents. -flf-. any, .table, DE> DRD£». .or 
YOD file . Ordinarily, the user Indicates one or more files to be listed, by name. If 
several files are named, they will be listed In the order given In the command. Files 
can be listed In their entirety, or the 
user can specify which line or lines of the 
file are to be listed. The user can also 
specify the device on which the listing is 
to be done. If no device ID Is given, the 
listing is transmitted to the use^s 
.ermlnal. If the characters "-P" are added 
after the word LIST, the output will go to 
the system line printer. 


1 Sequence table 

- ST !; 

1 Interface table - IT j 

Linkage table 

- LT ! 

Y-data table - 

YT 

Data elements 

- DE 

Disk-resident 

data elements - DF 

YOD file - YJ 



28-2. The OBJECT field is used to 
indicate a table or file. 

The SPAN field Is used to specify limits on the contents of tables or DEs to be listed . 
For tables and YOD files, the span specifies the entry numbers of the first and last 
table entries to be listed. For DEs, the span field consists of the subscripts of the 
Items to be listed. If either the start or end of the span Is not Indicated, the first 
or last entries, respectively, are assumed. The user may specify individual subscripts 
or a range of subscripts or any combination of these two. Only entire DRDEs may be 
I I -ted. 



MEANING 

EXAMPLE 

tn 

single entry number 


100 

<v 

r-t Cfl 
XI Q 

start entry number - 

end entry number 

100-600 

o 

4-» >* 

start entry number - 


100- 

For 

and 


- end entry number 

-600 

V) 

single subscript 


2 

U4 

Q 

start subscript - end 

subscript 

2-6 

; u 

O 

start subscript - 


2- 


- 

end subscript 

-6 


28-3. The SPAN field sets boundaries on the information to be listed. 
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The LIST command Is used to display the conterts of tables and files. Entire tables and 
files or only parts of tables and files can be listed. Ordinarily, the listings will 
use the same format as used In the table or file being listed. However, If a DE or DRDE 
uses the "free" data type, the user must Indicate the format to be used. 

LIST-devIce ID, object name(span)-f 1 1 e type,... 

The LIST function may he used as a directive within a table editor . To list the table 
being edited, the user need only specify the span of the table to be listed: 

LI ST, (200-500) 

If the span Is omitted, the entire table Is listed. 

LIST 

Any table or file can be listed, however, by using Its name with the LIST function. 

11-a D£ .or. fl.RBE. -cons late . o f L nfprmat.LQR th a t , is, . s tored, . a s f res data,... the .user 

supply the format to be used . In this case, FDS will prompt the user to supply the 
format to be used to list the DE or DRDE. If no format Is supplied, or If the LIST 
function Is executed from the batch mode, a hexadecimal format Is assumed. 


Dialogue 


LIST, BIG-DF 
FORMAT FOR NAME: 


Comments 


BIG has free data 

The user is prompted to supply the format, which 
may be: 

I: Integer 
R: Real 

D: Double precision 
Ch: Character (n=4 ,8 , 16 , 32 ,or 64) 

T : T ime 


28-4. The user supplies the format for free data. 


In solving the example problem, the user constructed an Interface table for the 
OMS-2 circularization burn (see "An Example of Interface Table Editing"). That 
entire IT, or sections of It, can be displayed using the LIST command. For 
example, by typing 

LIST,0MS2( 240-270) 

The user can obtain the following display: 

240 DENSM0DL=! IDENSMD 
250 S0LAFLUX=! ! SOLRMD 
270 SVPROP="AEG" 

This display Illustrates a situation In which the user must be aware of the 
circumstances. Entry number 260, a missing, optional parameter, Is not 
displayed here. IT entries which are (1) optional, and (2) not filled In, are 
not printed when the LIST command Is used. If they were, many missing entries 
would be printed even through they are not relevant to the case In question. 
Thus, the LIST command can be used to show all entries which have values 
(Including all required entries even If Incomplete), but only the EDIT command 
allows the user to see those additional entries which represent missing optional 
variables. 
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29 GET,. STORE* APPEND. SUBSTITUTE Commands (Permanent Storage and Retrieval of Files) 


The GET command , STORE command, APPEND command, and SUBSTITUTE command are used to 
obtain files from permanent data bases, and to store files In such data bases. 


Xhe GET-^ommand allows a user, to.. retrieve. all or-saiected portJflus-Qf. a PDB or MDB. The 
files thus retrieved are added to the current contents of the AWA. In using the 
command, the user gives the name of the data base which contains the files now. This 
may be an MDB (all users have access to these) or any PDB for which the user knows the 
name and access code. The user must also specify which file or files are to be moved. 


GET, data base name-type- access code, files to be moved 
STORE, PDB name -PD-access ccjc, files to be moved 
APPEND, PDB name- access code, files to be moved 
SUBSTITUTE, PDB name -access code, files to be moved 


29-1. Syntax of the GET, STORE, APPEND and SUBSTITUTE commands. 

The user may specify that all files, in the data base, are to be moved to the AWA. or. may 
move whole classes of files, or Individual files . If the "files to be moved" portion of 
the command is omitted, as In the command 
GET,EXPL-PD 

then all files are moved. Otherwise, a list of Individual file names, file type codes, 
or both, can be used. Ordinarily, a single file Is specified by giving both Its name 
and type, as In the command 

GET,EXPL-PD,0MS2- IT 

If only a mme Is given, the file is assumed to be a DE. If only a type code Is given 
(preceded by a hyphen), as In the command 
GET,EXPL-PD,-IT 

all files of the Indicated type are moved. These same conventions apply to the STORE 
and APPEND commands, which move files from the AWA permanent data bases. 



BB—B 

The effect is: 

1 

omitted 

all files in the source data » 
base (or AWA) are moved. 

2 

file type with no file 
name (e .g. , -ST) 

all files of the specified 
type art moved. 

3 

file name with no type 
(e.g., ABXYZ) 

a data element with the 
specified name is moved. 

4 

file name with type 
(e.g., OMS2-IT) 

the specified file is moved. 

5 

a list of specifications 
of forms 2, 3, and 4, above 
(e.g., ABXYZ, -ST, 0MS2-IT) 

each file or group so 
specified is moved. 


29-2. The "files to be moved" are specified in the same way for all four 
commands. 
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Transferring data from a PDB or MDB Into the AWA Is done with the GET command. The 
files retrieved are added to the current contents of the AWA. 

GET. data hase name-typ e- access code.flles to be moved 

Storage of AWA files Into a PDB Is done using the STORE or APPEND commands. STORE 
creates a new PDB, and places the Indicated AWA files In It. 

STORE. PDB name -PD-access code, files to be moved 

APPEND adds the Indicated files to an existing PDB. 

APPEND. PDB name - access code, files to be moved 

SUBSTITUTE purges all files In the named PDB, then stores the Indicated files there. 
SUBSTITUTE P PDB name - access code, files to be moved 

The APPEND. command is similar to GET^ but moves the files In the opposite direction, 
from AWA to PDB . The user specifies the name of the existing personal data base ±q 
which files are to be moved from the AWA. The Indicated flies are "appended" to the 
previous contents of that PDB. If any files to be moved have the same name as files 
already In the PDB, an error message Is generated and those part leu I ar files are not 
moved. Since the FDS user Is not allowed to modify the contents of master data bases, 
only a PDB can be named In this command. 


Jhfi-SIQRE command Is similar to APPEND, but 
creates a new PDB and moves the files from 
the AWA Into It . This command Is the 
mechanism for creating new PDBs, and Is the 
ordinary way of saving all the Information 
associated with a particular flight design. 
Although several approaches can be used. It 
may be easiest to delete all extraneous 
flies from the AWA, and simply store the 
rest In a new PDB by using the STORE 
command with no "files to be saved" 
specification. It should be noted that the 
PDB must have a different name than any 
other PDB having the same access code. If 
this condition Is not satisfied, an error 
message Is generated and no files are 
moved. A STORE command will also generate 
an error If the user already has the 
maximum number of PDBs. In this case, the 
user must delete an existing PDB, APPEND 
the files to an existing PDB, or create a 
PDB under another access code. 


Ihe-SUBSJJ TU TE. command Is similar— to -STORE* but plac e s A WA files 1 ntQ-aiL mist lxig.. PDB- 
after clearing It . All files previously In the PDB are purged, but the name and 
abstract of the PDB are retained. The Indicated AWA files (or the entire AWA) Is then 
stored In the PDB. 

In solving new flight design problems. It may be helpful to develop a "library" 
of standard flight designs. Flight designs In such a library can then be used 
as a starting point when new, similar flights are to be planned. If we suppose 
that a PDB ("GEOSYNCH") already exists for launching a geosynchronous payload, 
that flight design might easily provide a good starting point for the example 
problem. To load the PDB Into the AWA, the user might type: 

GET,GEOSYNCH-PD-AA 

The user would then modify the GEOSYNCH flight design as necessary, adding the 
additional payload, etc. When completed, the resulting flight design 
Information might be saved as PDB EXPL: 

STORE, EXPL-PD. 


Get all interface tables from a PDB: 
GET,FLIGHT1-PD,-IT 

Get entire MDB: 

GET,CONSTANT-MD 

Save entire AWA in new PDB: 

STORE, FLIGHT2 -PD 

Add specified Tiles to existing PDB: 
APPEND, FL.IGHT1 ,0MS2-IT,TRAJECT-ST 

Replace existing PDB with current 
contents of AWA: 

SUBSTITUTE, FLIGHT2 


29-3. Examples of GET, STORE, APPEND, 
and SUBSTITUTE commands. 
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30 TQC Commanu (List Names of Files, Data Bases, etc.) 


The TOC (Table of Contents) command allows the user to display a I 1st of files In the 
the AWA or a data base or to list X or Y jobs, X or Y processors, or available data 
bases. 


The basic purpose of the TOC command Is to list the contents of the AWA or. of any dat^ 
base to which the user has access . Thus, the command 
TOC 

produces a table of contents for the AWA, while the command 
TOC, , EXPL-PD 

produces a table of contents for the user*s PDB, called EXPL. Tables of contents for 
MDBs can also be produced. TOCs will be displayed on the user f s terminal, unless the 
system line printer Is specified, as 
TOC-P,, EXPL-PD 

When the TOC command Is executed In the batch mode the display automatical ly goes to the 
printer. 


TOC-device ID.class, data base name-classification code-access code 


30-1. Syntax of the TOC command. 


By specifying the file ty pe, th e user can obtain a. I J_st I es of_ a part IciiJ ar.. 

class which are contained in the AWA or. . In. a_ specified data ba se. Standard file type 
codes are used for this, so that 
TOC, ST 

produces a list of sequence tables In 
the AWA, while 

TOC, IT, EXPL-PD 

produces a list of Interface tables In 
the PDB named EXPL. 


Other class codes can be used lQ._l.Lsi 
the user f s jobs, or available data_ 
bases, processors^ or documents 
segments . For example, the command 
T0C,XP 

displays the names of all available X 
Processors. 


30-2. The TOC command lists a variety 
of objects depending on the 
"class" selected. 


Class 

Codes 

Meaning 

-ST 

sequence tables 

-IT 

interface tables 

-LT 

linkage tables 

-YT 

Y-data tables 

-DE 

data elements 

-DF 

DRDE files j 

-PD 

personal data base files 

-MD 

master data base files 

-YJ 

YOD files or Y-jobs 

-XJ 

X-jobs 

-XP 

X-processors 

-YP 

Y-processors 

-DS 

document/segments 
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A table of contents (TOC) Is associated with the AWA and each PDB and MOB. The 
table of contents Indicates the name, type, and size of each AWA or dala base 
entry. The TOC command Is used to display a table of contents and also to 
provide a list of X or Y Jobs or processors, or a 1 1st of available PDBs or 
MDBs. 

TOC-devIce ID, cl ass, data base name-c I ass I f Icat Ion code-access code 


In solving the example problem, the user will accumulate a number of Interface 
tables, data elements, etc., which will reside In the AWA until stored In a PDR. 
Some of these elements (e.g., Interface tables) are constructed by the user, 
while others (e.g., data elements) are constructed as the Flight Design System 
performs the commands In the sequence table. When the sequence table has been 
executed, the user can display the entire contents of the AWA via the command 
TOC 

and obtain a display similar to the following 


i TOC 

FOR THE AUA 


TRUE OF CONTENTS 

DATE 


• 16/02/1# TIRE • 15/23/ IS 


NAME 

AIS 

DATE 

TIME 

AC 

SIZE 




last l 


04/12/00 

11/47/36 

UE 

141 




PCOASTl 





384 




UNITS 


04/02/80 

17/25/20 

UE 

390 




DATA ELEMENTS 




TYPE 



NAME 

ASS 

DATE 

TIME 

AC 

SIZE 

R0U 

COL 

••DATE 


04/12/80 

11/47/36 

UE 

164 

M039 

50 


• SCOEF 


04/12/80 

11/47/36 

UE 

32 

M042 

15 


•SESCON 


04/02/80 

17/25/20 

UE 

288 

R041 

72 


SU01 


04/02/80 

17/25/20 

UE 

56 

F 

28 


SUIN 


05/16/80 

18/05/05 

UE 

56 

R072 

15 


TETAI 


05/16/80 

18/05/05 

UE 

240 

R073 

42 

2 

DADE FILES 








NARE 

AIS 

DATE 

TIME 

AC 

SIZE 

TYPE 

LRL 

FT 

ISF1LE 


05/16/80 

18/05/05 

UE 

1 

M072 

56 

I 

aua size 

• 18000 FREE • 14408 

( HALFWORDS ) 




DUA SIZE 

• 

400 FREE • 377 

(SECTORS) 




COMPACTIONS • 

0 . 

0 . 

0 . 

0 . 


0 , 

0 
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CLEAR. DELETE Commands (Eliminating c I I ©s from Storage) 


The CLEAR and DELETE commands are used to eliminate unneeded Information from storage. 


The CLEAR .command- jmrasa Ai L.f 1 les from .the 
uafir.'-s Active Work Area* This results in 
the deletion of all Interface tables, 
sequence tables, linkage tables, Y-Data 
tables, data elements, and disk-resident 
data elements. Because MDRs, PDBs, and 
YODs do not reside In the AWA, they are not 
affected. The CLEAR command can be used 
only at the Executive level (l.e., with a 3l-l . Syntax of the CLEAR coirmand. 

prompt of %: ). 


CLEAR 


The DELETE command can be used to el 1ml nate Ind 1 v l.dual. f! .Of Jiholfi .Classy .Qf. f 1 LfiS- 
by specifying file names and/or typ es. For example, the command 
DELETE, 0MS2- IT 

causes the Interface table M 0MS2 W to be discarded from the AWA. The space previously 
occupied by the deleted file Is thus made available for other AWA files. The command 
DELETE, -DE,-DF 

results In the elimination of all data elements and DRDEs (file type DF) from the AWA. 
This command might commonly be given before execution of a sequence table which 
constructs these elements, and might precede storage of the AWA as a PDB via the STORE 
command. 


DELETE, object name-classification code,... 
DELETE, (span) 


31-2. The DELETE command has two forms. 


Files which are In use cannot be deleted . For example, a sequence table cannot be 
deleted while It Is executing, as might happen If It contained a statement such as 
DELETE, -ST 

Similarly, a YOD cannot be deleted until the correspond I ng Y job has finished executing. 


The DELETE command can be jsed to eliminate PDBs by name . PDBs cannot be deleted as a 
class, but the user can delete his own PDBs by specifying their name and class codes, as 
DELETE ,EXPL -PD, OTHER- PD 

PDBs cannot be deleted If they belorg to access codes other than that used to log on. 


Ey-s&e&lf.ylna .f.lr.&t and las t . e ntry im mb.grsL l"smui ,l .),« .Uis iiser jcaa.afiletfi .a port Ian 
CUTJ£flt±y. ilfilnfl edited* Thus, the command 
DELETE, (20-40) 

deletes entries 20 through 40 of the table which the user Is editing. If a DELETE 
command specifies a portion of an Interface table, that portion Is merely cleared of 
values, but the variable names remain, since entries cannot be deleted from an IT. 


62 



The CLEAR command Is used to eliminate all files from the AWA. 

CLEAR 

The DELETE command Is used to eliminate Individual files or whole file classes from the 
AWA, to eliminate Individual PDBs, or to delete specified portions of AWA files. 

DELETE .object name(span)-c I ass 1 f Icatlon code.... 

DELETE. (span) 


OBJECT 

MEANING 

1. Name of PDB (e.g. , EXPL-PD) 

User's PDB with specified name 
is deleted. 

2. Name of file with file type 
(e.g., 0MS1-IT) 

Named file is deleted from AWA. 

3. Name of file without file 
type (a.g., RESULT) 

Named data element is deleted 
from AWA. 

4. Span only (e.g., (50-60)) 

Indicated span of entries is 
deleted from file currently 
being edited. 

5. File type only (e.g., -YD) 

All files of Indicated type are 
deleted from AWA. 

6. List of objects of types 
1-5. (e.g., -YD.M1NE-PD, 

(20-60)) 

Each object is deleted in turn. 


31-3. The DELETE command can be applied to a variety of objects. 


A typical work session begins with the loading of a PDB, as by the command 
GET.EXPL-PD 

in order to restore the conditions which existed at the end of the user’s 
previous session. In this case, the GET command restored the PDB Into which we 
placed all the files associated with the example problem. During the course of 
the work session, the user may modify some of these flies and wish to save the 
updated versions. One approach might be 
DELETE.EXPL-PD 
STORE, EXPL 

which saves the entire current contents of the AWA. To conserve disk space, the 
user might prefer to eliminate those files which can easily be reconstructed. 

In this case, the command sequence might be 
DELETE, EXPL-PD.-DE.-DF 
STORE, EXPL 

When this operation Is completed, the user can sign off or begin a new problem, 
as with the commands 
CLEAR 

GET .NEWPROB-PD 

which clears the AWA of the remnants of the old problem before obtaining 
Information associated with the new. 


I 
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(File Duplication and Name Changing) 


The COPY command allows the FDS user to duplicate and rename a table, DE, DRDE, or PDB, 
while RENAME only changes the name of the original. 


to the new copy . The object may be a 
sequence table. Interface table, linkage 
table, or Y-data table, as In 

C0PY,TRA JECT-ST, SAVET 
or a data element or DRDE, as In 
C0PY,RESULT,RESULT2 
COPY , B I GF I L E-DF , WORKCOPY 
or a PDB, as In 

COPY , H I SPDB-PD-HE , MY PDB. 

In the case of PDBs, the new copy will have 
the access code under which the user logged 
on, regardless of the access code of the 
original PDB. All other objects are copied 
f rom the AWA the AWA. In every case, 
the new name must not conflict with the 
name of any existing object of the same 
class. 



32-1. Syntax of the COPY command. 



32-2. Syntax of the RENAME command. 


copy . The objects which can be renamed are 
the same as those which can be copied, 
except that the user may rename only his 
own PDBs. Thus, the user can RENAME tables 
and DRDts, 

RENAME, BUILD- IT, 0MS2 
data elements 

RENAMt ,DATA, SAVEDATA 

or PDBs 

RENAME, EXPL-PD,TEMPSAVE. 

The new name must not conflict with any 
existing object of the same class. 






ID tag , lhls Information, which Is associated with every file o* PDB, can be useful In 
determining when files were constructed or last modified. Actually, the date/time 
Information Is set to zero to Indicate ’’current" Information and Is only replaced by a 
real date and time when the file Is stored In a PDB. Thus, a date/time tag of zero (In 
a TOC dlspay, for example). Indicates a file which has been generated or modified during 
the current user session. If the user makes use of the date/time Information, It should 
be kept In mind that even renaming the file causes the date and time to be updated. 


stored . Any references to the old file name which are made In sequence tables. 
Interface tables, etc., are left unaltered. It Is the user's responsibility to Insure 
that such references point to the correct file. 
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The COPY command Is used to copy and rename tables, DEs, DRDEs, and PDBs. 
COPY , oh ject.jJia* .name 

The RENAME command changes the name of a table, DE, DRDE, or PDB. 

RENAME . object-new name 


Although COPY and RENAME operations can be done for a variety of purposes, a 
particularly common reason Is the saving of files or data bases which are about 
to be changed • In the example problem, the user works with a PDB cal led EXPL, 
which Is assumed to be loaded (via the GET command) at the end of each session. 
Thus, a session might Include the commands 
GET, EXPL-PD 

SUBSTITUTE, EXPL-PD 

( The SUBSTITUTE command Is used. Instead of STORE, because the STORE command 

cannot construct a PDB whose name conflicts with one already In existence. It 
Is easy to Imagine circumstances In which the user warn to save this PDB, so as 
to have a back-up copy of the PDB as It existed before th<_ session. In this 
. case, the commands, 

RENAME , EXPL-PD , BACKUP 
STORE, EXPL-PD 

might be used In place of SUBSTITUTE. 


A similar situation sometimes exists with respect to data elements or DRDEs. In 
the example problem, the TRmJECT sequence table builds, among other things, a DE 
called ‘‘RESULT”. When modifications are made to TRAJECT, or to Interface 
Tables, etc., which are used In executing TRAJECT, It might be desirable to save 
a copy of RESULT. The new RESULT can then be compared with the saved copy In 
order to observe the effects of the changes. Since TRAJECT builds. In effect, a 
new copy of RESULT each time It is executed, the RENAME command can be used: 
RENAME , RESULT, SAVECOPY 

The reader will recall that the file type can be omitted when the file Is a DE. 




The COPY command Is the right mechanism to use when the file Is built directly 
by the user. Suppose, for Instance, that the user Is about to modify 0MS2-IT, 

and wants to keep an unmodified version. An appropriate command might be * 

C0PY,0MS2- IT, SAVE0MS2 

The user can then edit the 0MS2 file as desired, as by the command 
ED IT,0MS2- IT 

or the CHANGE command (discussed later). It should be noted that the EDIT 
command accomplishes a similar, but not Identical, function. The command 
ED!T,0MS2- IT,SAVE0MS2 

also results In the existence of two copies, but the file called '*0MS2'' Is the 
unmod I f led version. Another approach to the COPY and EDIT sequence above Is 

RENAME , 0MS2- IT, SAVECOPY * 

ED IT, SAVECOPY- IT, 0MS2 


Anofher common use of RENAME Is the situation In which the user wants to GET 
files from two or more data bases, but some files have the same name. Suppose, 
for Instance, that the user Is beginning the solution of the example problem and 
wants to construct the TRAJECT file by merging two existing TRAJECT files, one 
of which resides In the GEOSYNCH PDB and one In the CIRC200 PDB. The commands 
used might Include 
CLEAR 

GET, GEOSYNCH-PD-XY 
RENAME, TRAJECT- ST, TEMP 
GET, Cl RC200, TRAJECT- ST 

followed by the merging of the two files (see INSERT command). 
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33 CHANGE INSERT Commands (Modifying and Merging) 


The CHANGE command is used to modify abstracts or table entries, while INSERT merges the 
contents of two tables. 

TJie CHANGE command can he used t o alter Information In .a ta ble w hich Is freln.a edited. 

The command must specify which entry or entries are to be changed. Within the specified 
span of entries, a search will be made for all occurrences of the Indicated "current 
data". Each occurrence will be replaced by the "new data". Current and new data may be 
object names, as In the command 

CHANGE , ( 300-3 00 ) , I TAB 1 , 1 TAB A 

which replaces an Interface table name In line 300 of the table currently being edited. 

In STs only, they may be numbers, as In m 

CHANGE, (10-), 14, 286. 3E-14 

(which searches all entries from 10 to the end of the file). Or (in STs) they may be 
special symbols 

CHANGE, (1285-1286),+,- 

except that the comma and quotation mark (") may not be used in this way. The comma Is 
used In the command Itself, and quotation marks are reserved as delimiters for string 
literals, which are also allowed, as In 

CHANGE , ( -65 ) , "GPMP, 0M", "FLT, FP" . 

In STs, the "current data" and "new data" need not be of the same type. Commands like 
CHANGE , ( 287-290 ) , ! ! I NPUT , 26 

are acceptable. Furthermore, several whole elements of these types may be strung 
together In order to unambiguously Identify the desired current data or to replace this 
Information with several elements, as In the command 
CHANGE, (20-20) ,0MS2-ST,0MS2- IT 

It Is the user’s responsibility to Insure that the new data satisfy the requ I rements of 
the table type being modified. The syntax of the table Is not checked until the table 
I s actual ly used. 


To alter abstracts: 

CHANGE, object name-classification code, current data, new data 
To alter table being edited: 

CHANGE , (span) , current-data ,new data 


d 


33-1. The CHANGE command has two forms. 


ST = sequence table 

IT * interface table 

LT = linkage table 

YT - Y-data table 

DE = data element 

DF = disk-resident data element 

PD = personal data base 

XJ = X job 

XJ « YOD file or Y job 


33-2. CHANGE can alter the abstract of 
any object type which has abstracts. 


Ite CHANGLc jmmafid can alsQ.be used to . 
alTer the r intents of any abstract . In 
this case, the command must name the object 
and Its type, but does not, of course. 
Include entry numbers. For example, the 
command 

CHANGE, EXPL-PD, "LUNCH", "LAUNCH" 
searches the entire abstract of the EXPL 
PDB for occurrences of the string "LUNCH" 
(without quotation marks) and relaces each 
such string with "LAUNCH". 
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The CHANGE command Is used to modify abstracts or to modify a table which Is currently 
being edited. 

CHANGE . object name-classification code. current data. new data 
or CHANGE. (span) .current data. new data 

The INSERT command Is used to combine all or a selected portion of a specified table 
with another table, of the same class, which Is currently being edited. 

INSERT, source table name(span) , Insert location 


When used with sequence tables or Y-data tables, the INSERT command al lows, al_l__Qr. .parjL 
of a table to be inserted Into the table being edited . The Inserted Information may be 
taken from some other table, as In the command 
I NSERT,TRAJECT-ST 

which Inserts the entire TRAJECT sequence table at the end of the sequence table which 
Is currently bong edited. Alternatively, Information which Is already In the current 
table can be Inserted In the same table by omitting the name of the source table. This 
Is useful wher, a particular segment of the table Is to be repeated, perhaps with small 
changes, somewhere else In the table. For example, entries 20-40 of the current table 
are duplicated at the end of the table by the command 
INSERT, (20-40) 

The command can also specify that the Inserted Information Is to be placed after a 
particular entry number. Thus the command 
I NSERT, SAVETRAJ ( 1 00-200) -ST, 70 

Inserts line 100-200 of the SAVETRAJ sequence table after entry 70 of the sequence table 
which Is being edited. To Insert at the beginning of the table, the user Indicates that 
the Insertion Is to be made after the (nonexistent) entry zero, as In 
I NSERT, PRELIM- ST, 0. 

Whenever INSERT Is used with a sequence table or Y-data table, the table entries are 
renumbered (10, 20, 30, etc.). Incidentally, FDS does not allow the INSERT operation to 
occur when the source table and edited table are not of the same type (this operation 
wouldn't make sense, anyway). 


INSERT , source table name (span) -file type .insert location 


33-3. Syntax of the INSERT command. 

With Interface tables and linkage tables. INSERT causes a logical merging of the twe 
tables . Because the structure of these tables Is fixed. It Is not possible to Insert 
Information between two existing entries. Thus, no Insert location Is al lowed. For 
these tables, the table being edited Is retained Intact, except that all existing 
parameter values In the source table replace those In the edited table. That Is, any 
entry In the source table which h as a value will replace the corresondlng entry In the 
edited table, whether 11 already nad a value or not . 


If the table being 
edited is 

and the source 
table is 

then the 
command 

yields the result 

Sequence table: 

10, PERFORM, PA, TA 
20, PERFORM, PB,TB 

B-ST: 

10, STORE 
20,LIST,DE1-DE 

INSERT, B, 10 

10, PERFORM, PA, TA 
20, STORE 
30, LI ST, DEI -DE 
40, PERFORM, AB,TB i 

Interface table: 
40, D= BETA 
60,F=1,2 

A-IT: 

10,A=1, 2 , 3 
60,F=ALPHA 
80, ?{■!,&, 2 

INSERT, A 

10 , A=1 ,2,3 
40 ,D=BETA 
60 ,F-ALPHA 
80 , H=1 , & , 2 ' 


33-4. INSERT has different effects for different table types. 
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34 CROSS REFERENCE. FIND Commands (Locating Information In Tables) 

The CROSS REFERENCE command finds all references to specified objects within 
AWA-resIdent tables, while FIND searches one particular table or table segment for Hems 
which need not be object names. 

• 

The CROSS REFERENCE command Is used to locate all references to a aar±i.cuJ.ar labLe_or_ 
other object . Suppose, for example, that the user wishes to substitute Interface table 
0MS2A for 0MS2 In certain Instances, but not In others. It might be helpful to use the 
CROSS REFERENCE command to locate all references to 0MS2 In existing sequence tables In 
the AWA: 

CROSS REFERENCE, -ST,0MS2- IT 

This causes a cross reference display to be presented on the user’s terminal, showing 
each Instance, In any sequence table, of a reference to 0MS2. The command can be used 
to search only a particular table, as In 

CROSS REFERENCE, TRAJECT- ST, 0MS2- IT 

which searches only the TRAJECT sequence table. When searching for references to data 
elements, DRDEs, or X Processors, the user may prefer to allow all AWA tables to be 
searched, regardless of type. DEs, for example, can be referred to from any table type. 
This Is done by simply omitting both table name and type from the command: 

CROSS REFERENCE,, RESULT-DE 

By adding the line printer device code (-P) to the command, the user can cause the 
display to go to the system line printer: 

CROSS REFERENCE-P, , GPMP-XP 


CROSS REFERENCE-device ID, searched table name-file type, reference name -class 


34-1. Syntax of the CROSS REFERENCE command. 


CROSS REFERENCE can be used to search for a variety of object tvfl-as . The user can 
search for any table (Interface table, sequence table, Y-data table, or linkage table), 
as well as data elements, DRDEs, data bases (PDBs and MDBs), X Processors, YOD files, 
and document/segments. 


If the item 
searched for is: 

then the following table types may be searched. \ 

ST _ 

IT 

YD 

LT 

Sequence table (ST) 





Interface table (IT) 





Y-data table (YD) 

X 




Data element (DE) 

X 

X 

X 

X 

Disk-resident data element (DF) 

X 

X 


X 

Personal data base (PD) 

X 




Master data base (MD) 

X 




YOD file (YJ) 

X 




X Processor (XP) 

X 

X 



Document/segment 




X 


34-2. Not all search and reference combinations are valid in CROSS REFERENCE commands. 
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The CROSS REFERENCE command Is used to search AWA-resIdent tables for references to 
tables, DEs, DRDEs, data bases, YOD flies, X Processors, and document/segments. 

CROSS REFERENCE-devIce ID, searched table name-file type P ref erence name -class 

The FIND command searches an Individual table for specific names, numbers, springs, or 
special symbols. 

FIND, searched table name(span )-f 1 1 e type. data 


I tie FIND command Is somewhat similar, but can search for other data . Each entry, thus 
found, Is displayed on the user’s terminal. The search data can consist of object 
names, as In CROSS REFERENCE, but can also Include numbers 
FIND, ITAB- IT, -27 .6 

or. In sequence tables, qualifiers (classification codes, device codes, and access 
codes, which are normally preceded In use by a hyphen). FIND can search for individual 
symbols 

FIND, I SEQ-ST,+ 

as well as character string segments 

FIND, ISEQ-ST,"SPIDPO SUPPORT. ON" 

Furthermore, several components can be strung together in order to uniquely identify the 
Information sought, as In the command 
FIND, ISEQ-ST,ABC+10. 

These must be whole components, however. The above command would not find an entry 
containing the group 
BABC+10 

since It looks for the whole name "ABC" followed by a plus sign and the number 10. The 
search data may not Include a comma (unless It is part of a string literal), since the 
comma would be taken as part of the syntax of the command, rather than as part of the 
search data. And, of course, quotation marks may be used only as part of a string 
literal. A command such as FI ND, I SEQ-ST,END. " Is not allowed. Percent (%) and 
semi-colon (;) characters are also not allowed, except within a string literal. 


FIND, searched table name(span)-file type, data 


34-3. Syntax of the FIND command. 


The FIND command can be used to searcn indiv i dual tables or table segments . Multiple 
tables cannot be searched with a single FIND command, as they were with CROSS REFERENCE. 
If the table to be searched Is currently being edited. It need not be named. Thus, 

F I ND, ,0MS2- IT 

searches the table now being edited for references to 0MS2-IT. The span can be limited 
by specifying startinq or ending numbers In the usual way, as In the commands 
F I ND , ( -500 ) , 0MS2- I T 
FI ND,TRAJECT (300-500 )-ST,0MS2 
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35 AT TRIBUTES. PERFORM Commands (X Processor Properties and Execution) 


The ATTRIBUTES command displays the attributes of all or selected parameters of an X 
Processor (or document/segment), while PERFORM causes the X Processor to be executed. 


The ATTRIBUTES command allows Ihe FDS user to display. Information abou1_tlie_iriDut/QutDut 
parameters of an X Processor . The user may specify particular parameters, or may obtain 
an attributes display for all the parameters associated with the processor. Thus, the 
command 

ATTR I BUTES, GPMP-XP, APSOPT, SUMTABLE 
produces the following display: 

ATTRIBUTES DISPLAY FOR PROCESSOR GPMP VERSION 6 


ENTRY 

KEYWORD 

SIZE 

ROW 

COL 

CLASS 

TYPE 

I/O 

R/0 

19 

APSOPT 

2 

1 


DE 

C4 

1 

0 

39 

SUMTABLE 

368 

4 

46 

DE 

F 

0 

R 


This display Indicates that entry no. 19 Is for parameter APSOPT. APSOPT occupies 2 
physical half-words and Is a single logical entity (an array of size 1, If you like). 

It Is defined as a data element (CLASS = DE) containing character data of up to 4 
characters (TYPE = C4). It Is an Input parameter (I/O = I) and Is optional (R/0 = 0). 
Entry 39 Is for parameter SUMTABLE. This Is a two-dimensional array (4x46 elements) 
occupying 368 half-words of storage. It Is a data element and contains free data. It 
Is an output parameter and Is required. TMs particular display was obtained because 
the command specified the parameters APSOPT and SUMTABLE. If no parameters are 
specified, as In the command 
ATTR I BUTES , GPMP-XP 

then all parameter attributes are displayed. Like most display-generating commands, 
this one can be made to produce Its output on the system I Ine printer, as In the command 
ATTR I BUTES-P, GPMP-XP 

If an interface table Is currently 
being edited, the attributes of the 

sfliresp on dlng X P rocessor can easily 

be displayed . For example, the user 
may be editing the 0MS2 table for 
processor GPMP, and be prompted as 
fol lows: 

\24 ,SVPR0P=: 

Responding with a question mark, 

\24 ,SVPR0P=: ? 

results In the display of Information 
about the nature of the parameter, but 
does not provide attributes 
Information. Thus, the user may not 
know the size of an array, or. In this 
case, whether or not the parameter Is 
required. By entering the update mode 
and typing an ATTRIBUTES command, the 
user can obtain such Information. To 
obtain Information About the X 
Processor for which an IT Is being 
edited, the user simply omits the X 
Processor name. Thus, the sequence 
might be 

\24,SVPR0P=:\ 

\: ATTR I BUTES,, SVPROP 

35-1. The ATTRIBUTES display for an X Processor 
provides information about all of its parameters. 


1 ATTRIBUTES DISPLAY FDR ^OCCESSCR 3?MP 



VERSION 6 


entry 

KEYWORO 

SIZE 

RCW COL 

CLASS 

type 

1/0 

R/0 

1 

GE0C0N 

60 

15 

DE 

0 

I 

R 

2 

PHYCDN 

60 

15 

DE 

0 

I 

R 

3 

GSL 

4 

1 

DE 

0 

I 

R 

4 

LBMKG 

4 

l 

DE 

0 

I 

R 

5 

FTM 

4 

1 

DE 

0 

I 

R 

6 

SESC0N 

238 

144 

DE 

F 

I 

R 

7 

SDATE 

164 

32 

DE 

r 

I 

R 

S 

PR0C0N 

14 

7 

DE 

F 

I 

R 

9 

INUEC 

56 

28 

OE 

F 

I 

R 

10 

THRUST 

2 

1 

DE 

R 

I 

R 

11 

ISP 

2 

l 

DE 

R 

I 

R 

12 

ENGID 

2 

1 

DE 

C4 

I 

R 

! 13 

HANI0 

2 

1 

DE 

C4 

I 

R 

14 

DELU0PT 

2 

1 

DE 

C4 

I 

0 

15 

DUCC.VP 

6 

3 

DE 

R 

l 

0 

16 

angle 

2 

1 

DE 

R 

I 

0 

17 

ALT0FT 

2 

1 

OE 

C4 

I 

0 

18 

ALTITUDE 

2 

1 

DE 

R 

I 

0 

19 

APSOPT 

2 

1 

DE 

C4 

I 

0 

20 

HA 

2 

1 

DE 

R 

I 

c 

21 

HP 

2 

1 

DE 

R 

I 

0 

22 

NUM0RB 

2 

1 

OE 

R 

I 

0 

23 

ONSFLAG 

2 

1 

DE 

C4 

I 

0 

24 

SUPR0P 

2 

1 

DE 

C4 

I 

R 

25 

OR0PC0N 

22 

11 

DE 

F 

I 

0 

26 

CD 

2 

l 

DE 

R 

I 

0 

27 

AREA 

2 

1 

DE 

R 

I 

0 

28 

0ENSM0DI 

0 

150 

OE 

F 


0 

29 

SC0EF 

32 

16 

OE 

F 

I 

0 

30 

S0LRFLUX 

246 

123 

DE 

F 

I 

0 

31 

GE0P0TEN 

0 

86 

0E 

F 

I 

0 

32 

DISPLAY 

2 

1 

DE 

C4 

I 

R 

33 

DSPUNITS 

288 

144 

OE 

F 

I 

R 

34 

IGUECNAM 

3 

1 

OE 

C16 

I 

0 

35 

3RUECNAH 

8 

1 

OE 

C16 

I 

R 

36 

o$pti«ei 

4 

2 

0E 

C4 

I 

R 

37 

DSPTIME2 

4 

2 

DE 

C4 

I 

R 

38 

GP-PTET 

0 

60 3 

DE 

F 

0 

R 

39 

SUITABLE 

368 

4 46 

OE 

F 

0 

R 
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The ATTRIBUTES command allows the user to display the attributes of all or selected 
parameters of a specified X Processor or document segment. 

ATTR IBUTES-dev Ice ID, object name-c I ass, parameter keyword,.. • 

The PERFORM command causes a particular X Processor to be executed. 

PERFORM. X Processor name . Interface table name 


The A TTRIBUTES c ommand can also.be used to obtain -Informatloa afag.uL.lhe parameters . 
associated w i t h a pa rt icula r . d ocumfint/seflinfiiit* This use of attributes is discussed 
further In the later section on document preparation. 


ATTRIBUTES -device ID, object name-class , parameter keyword,... 
PERFORM. y Processor name . inter face table name 


35-2. Syntax of the ATTRIBUTES and PERFORM commands. 

X Processors are executed by using the PERFORM command . Ordinarily, the user will 
specify not only the X Processor name, but also the name of the Interface table to be 
used for Input/output control. Thus, a typical PERFORM command Is 
PERFORM , GPMP , 0MS2 

It Is possible, however, to Initiate execution of an X Processor using the default IT 
for that processor, as by the command 
PERFORM, GPMP 

Whenever a value Is needed which Is not provided In the default IT (or whatever IT Is In 
use), the editor will automatically be Invoked by the system. In order to obtain the 
value from the user. Thus, It Is possible to successfully execute a processor without a 
specially prepared Interface table, although In most cases this Is rather tedious. This 
approach also has the disadvantage that the values Input are not permanently stored, and 
must be re-entered If the processor Is executed again. Like most commands, PERFORM can 
be used as a statement In a sequence table. It will be very common to collect a whole 
series of PERFORM commands In a seauence table In order to execute them In one 
operation. 


As was Just Indicated, the usual mode of FDS use Involves construction of 
Interface tables before X Processor execution. During the IT editing process, a 
variety of commands may be used (all from the update mode, of course). Included 
among the commonly used commands are LIST, CHANGE, and ATTRIBUTES. The 
ATTRIBUTES command Is helpful when the user Is uncertain of the properties of a 
parameter and must know them In order to successfully complete the editing 
operation. Thus, during Initial construction of the 0MS2 IT, the user might 
encounter a prompt for the parameter PROCON and be unsure of the number of 
elements to be provided. Use of the ATTRIBUTES command settles this Issue. 
'8,PR0C0N=:\ 

\: AT,, PROCON 

The user will recal I that command keywords can be shortened to as few as twe 
characters. If desired. The "AT" here Is short for "ATTRIBUTES". 

ATTRIBUTES DISPLAY FOR PROCESSOR GPMP VERSION 6 

ENTRY KEYWORD SIZE ROW COL CLASS TYPE I/O R/0 
8 PROCON 14 7 DE F I R 

: MODE, I 
\8,PR0C0N=: 

When the editing has been completed, the GPMP processor can be executed. 

PERFORM, GPMP, 0MS2 

Alternatively, this PERFORM command can be placed In a sequence table for later 
execution as part of sequence. 



36 AUTOMATIC, SEMIAUTOMATIC* and BATCH ucmiuands (Execution of Sequence Tables) 


The AUTOMATIC, SEMIAUTOMATIC, and BATCH commands allow execution of sequence tables with 
varying levels of user Interaction. 


The AUTOMATIC command executes a sequence of statements whlch_Jiave .been ^restored Inva- 
des lonated sequence table . Each statement Is executed as It Is encountered In the 
sequence table. User Interaction will occur only If the system detects Incomplete data, 
or If ar. X Processor Is executed which Is Itself Interactive with the user. In the 
absence of these clrcumslances, the entire sequence table will be executed before any 
further user Input Is required. The user specifies the sequence table to be executed 
AUTOMAT I C , TRA J ECT 

ie ST must be In the AWA for execution to occur. The user may specify that a portion 
cf the ST Is to be executed, by providing starting and/or ending entry numbers. Thus, 
AUTOMAT I C , TR A J ECT ( 20-23 0 ) 

executes entries 20 through 230 of ST TRAJECT before returning control to the user. 


AUTOMATIC-trace level. sequence table name (span) 

SEMIAUTOMATIC. sequence table name ( span) 

BATCH-trace level. data base. sequence table name ( span) . .lob limits 


36-1. Syntax of the AUTOMATIC, SEMIAUTOMATIC, and BATCH commands. 

By specifying a trace level, the user can cause the system tojirlnt statements, before . 
executing them . If the trace level selected Is "C", only "comments" Inserted In the ST 
via the NOTE command are printed. 

AUTOMAT I C-C, TRAJECT 

If the trace level Is "A" (for "ALL"), the system prints both NOTES and executable 
statements 

AUTOMAT IC-A, TRAJECT 


The SEMIAUTOMATIC command behaves In the same 
way*, .except th at I t stops l or, user act log. 

Before each statement I n -ilia. sequence table. 

If, for example, the user executes statements 
1000 through 1200 of the TRAJECT sequence 
table, 

SEM I AUTOMAT I C, TRA J ECT ( 1 000- 1 200 ) 
the system will respond with 

1000, PERFORM, GPMP,ETSEP 
S1000: 

This response Indicates the statement which 
Is about to be executed, as well as Its entry 
number In the table. The user may cause the 
statement to be executed by pressing the 
carriage return. Alternatively, the user 
may: 

o Skip to the next entry (by typing $) 
o Specify the entry number of another 

statement at which execution Is to begin 
o Type In a statement to be executed 
o Abort the ST execution (by typing %) 
o Obtain a list of legal commands (?) or 36-2. These commands differ primarily with 
the syntax of a particular command reqard to interaction with the user. 

(by typing, e.g. , L 1ST? ) 


AUTOMATIC: 

Interacts with user only when 

(1) incomplete data detected 
(Editor is invoked) 

(2) an X Processor directly 
interacts with user 

SEMIAUTOMATIC: 

As above, and before each statement. 

User can skip statement, override 
it, or allow it to be executed 

BATCH: 

None. User need not even be 
logged on when ST is executed. 
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The AUTOMATIC, SEMIAUTOMATIC, and BATCH commands cause the execution of entire sequence 
tables. AUTOMATIC executes the entire ST without user Interaction (unless Incomplete 
data exist or an Interactive processor Is executed). 

AUTOMAT I C-tr ace I evel .se quence table name (span) 

SEMIAUTOMATIC halts before the execution of each statement, allowing the user to concur 
or to skip or overlde the statement. 

SEMI AUTOMAT 1C. sequence table name (span) 

BATCH causes the later execution of the ST In background mode, with no terminal 
Interaction. 

BATCH-trace level. data base. sequence table name ( span ). job limits 


RESPONSE 

EFFECT 

Carriage Return 

Statement is executed 
as displayed. 

S 

System skips to next 
jtataner t in ST. 

Entry number 
(e.q. , 1210) 

System skips to indicated 
statement in ST. 

Any legal 
statement 

System executed this 
statement instead of the 
one it displayed. 


ST execution is aborted 
and control is returned 
to the F0S Executive. 

? 

System displays a list of 
leqal statements. 

Coronand? 
v’e.g. , LIST?) 

System displays the 
correct syntax of the 
specified statement. 


The BATCH command causes FDS to execute a 

s&Quence ta ble l a ter, as-^.VhatchV-Qr 

background, job . This al lows more 
efficient system operation when the user 
does not require Instant turnaround, and 
also allows the user to leave or do other 
work while the Job Is executing. It also 
has the advantage that It produces a 
hardcopy ( 1 1 nepr l nter ) record of the entire 
execution. Since no AWA will exist for 
this job at the vlme execution Is begun, 
the user must specify the name of a PDB or 
MDB. Thus, the command 

BATCH, EXPL-PD,TRAJECT 

Indicates that FDS Is to use the PDB cal led 
EXPL as If It were the AWA, obtaining the 
TRAJECT file from that PDB, as we I I as al I 
required Interface tables, data elements, 
etc. When the system has executed this 
command (l.e., submitted the job for later execution). It will return a job name to the 
user, who may then log off or do other FDS work. Later, when FDS executes the job. It 
will work from the EX^L PDB as It exists then , so It Is Important that It be left Intact 
until the Job has finished executing. 


36-3. During SEMIAUTOMATIC exe- 
cution, the user has several options 
available each time the system dis- 
plays the "next statement". 


Ihe. .BATCH command cari.aisQ.5fleclf.vi a t race l e veU execute .only a segment of. a seflueace 
table, and specify job limits . Thus, the command 
BATCH- A, FL I GHT-MD , BU I LDPLN ( 1 0-200 ) 

directs FDS to execute lines 10-200 of the BUILDPLN sequence table from an MDB called 
FLIGHT, and to list each statement before executing It. Job limits can be added In 
order to control the disk space, CPU time, and number of print lines allowed. The 
default values of these parameters should be satisfactory for most batch jobs, but the 
user may override them when necessar/. For example, the command 
BATCH , H I SPDB-PD-AY , 0TT2 , 800 ,240,25 

sets limits of 800 disk sectors, 240 cpu seconds, and 25,000 print lines. 



36-4. The "job limits" portion of the BATCH command has three components. 
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37 ALLGCAL. ASSIGN Commands (Data Element Creation and Initialization) 


The ALLOCATE command Is used to create a data element In the AWA with user-specified 
properties, while ASSIGN Is used to place Information Into an already allocated DE. 


ALLOCATF t data element name (dimension,dimet,sion) -data type ,. . . 
ASSIGN, data element name (expression,expression) =expression 'range '..-i 


37-1. Syntax of the ALLOCATE and ASSIGN commands. 

The ALLOCATE command creates one or more new data elements in .the. AWA . In this command, 
the user specifies the name of the new DE, which must not conflict with any existing DE 
names. The user also specifies tho data type which the DE will contain. For example, 
the command 

ALLOCATE, NUMVAL- I 

creates a DE celled "NUMVAL 1 ' which will contain a single Integer value. The data types 
available are Integer (I), real (R), double precision (D), character (Cn), free (F), 
time (T), or mixed (Mn, where n * format number). ALLOCATE can also specify the 
dimensions of a DE which Is to be used as an array. These arrays may have one or two 
dimensions, and are specified by giving the upper limit of each subscript, as might be 
done, for example. In a FORTRAN DIMENSION statement. Thus, 

A L L OC ATE , ON E D I ME N ( 1 6 ) -R , TWOD I ME N ( 2 1 , 4 ) -D 

creates two new data elements. The DE called ONEDIMEN Is to contain an array of 16 real 
values, which will occupy 64 bytes of 
storage (each real variable takes 4 bytes 
of storage). Values In this array will be 
referred to by name and subscript, so that 
0NEDIMEN(3) Is a reference to the third 
value In this array. TWODIMEN contains 84 
double precision values (672 bytes) and Is 
referenced with two subscripts. For 
example, TWOD IMEN(6,2) refers to the second 
value In the sixth row of the 21 x 4 array. 

Data elements m. y not be allocated for more 
than 4095 bytes, or an error message will 
result. 

The ASSIGN command computes values and stores them In a DE . Functionally. ASSIGN Is 
very similar to the assignment statement found In FORTRAN or other high-level 
programming languages. Thus the command 
ASS IGN, NUMVAL- 1 0; 

simply places the value 10 In the (single-valued) data element called NUMVAL. 

Expressions for the value can be arbitrarily complex. Involving addition, subtraction, 
multiplication, division and/or exponentatlon. They may Include a variety of 
mathematical functions (see Appendix A) and nested parenthetical expressions. 

Expressions are evaluated In the conventional way (as In FORTRAN, for example), so that 
the command 

ASS IGN, NUMVAL =4 "2* *3-6/ 2+3 ; 

Is evaluated as If It had been written 

ASS IGN, NUMVAL* (4* (2**3) )-(6/2)+3; 


DATA TYPE 

BYTES PER VALUE j 

integer (I) 

2 - 

real (R) 

4 

double precision (D) 

8 

character (Cn) 

4, 8, 16, 32, or 64 

free (F) 

words allocated 
(4 bytes each) 

time (T) 

8 

mixed (M) 

combinations of 
above types 


37-2. The data type of a DE affects its 
storage requirements 
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The ALLOCATE command Is used to create one or more data elements In the AKA. The user 
must specify the name and type of the data element and may specify Its dimensionality. 
ALLOCATE . data element name (d Imens lon f d Imenslon )- data type . . . . 

The ASSIGN command computes values and stores them In an existing AWA-res I dent DE. 
ASSIGN. data element name (expresslon f expresslon) g expresslQn ’range '...I 


Involves multiplying an Integer (2) by a data element value (using whatever data type It 
has), multiplying the result by a real constant, and converting the result back to an 
Integer (NUMVAL was ALLOCATEd, above, as an Integer). No conversion Is applied to free 
data, however. Character strings may also appear as values, as In the command 
ASS IGN,HOLDCHAR=" SPACE TRANSPORTATION SYSTEM"; 
but arithmetic operations are then not allowed. The ASSIGN command must be terminated 
with a semicolon. 


liB II uBil B UM 


Subscripts can be any valid numerical expressions, as defined above. Thus, 

ASS IGN,ONED IMEN(2***2-1 4/7) =12; 

Is valid, and Is equivalent to 
ASS IGN,ONEDIMEN(2)=12; 

Naturally, references to two-dimensional arrays require two subscript expressions: 
ASS I GN, TWOD I MEN (ONED I MEN ( 1 ) ,6-NUMVAL ) =26 . 1 83 ; 




array . This Is done In a manner similar to the ordinary DO statement In FORTRAN. For 
example, the command 

ASSIGN, TARGET (I )=SOURCE(l) *1=1,10; 

copies the values of an entire ten-element array (SOURCE) Into another array (TARGET). 
The range specification Is Indicated by an apostrophe, and contains the following 
Information: 

, ifid£A=l.nJtLal I ua* lamina ! v alue, I ncrement 
where the Increment Is optional. The "Index" Is a variable name. The variable takes 
Integer values as Indicated by the remaining Information. For the first Iteration, the 
Index Is equal to the Initial value. On each successive Iteration, the Index value Is 
Increased by the Increment until It exceeds the terminal value. Thus 
* IVAL=1 ,10,3 

causes IVAL to take on the values 1, 4, 7, and 10. The next value, 13, Is past the 
terminal value, so the fifth Iteration does not occur. If the Increment Is not 
specified, a value of I Is used (-1, If terminal value Is smaller than Initial value). 
More than one range specification can be used, to a maximum of four. Thus, 

ASS I GN, PRODUCT ( I , J) = l *J 
CONTINUE: *1=1,6 *J=1,4; 

assigns values to all 24 elements of a 6 x 4 array. In each case, the value assigned Is 
equal to the product of the row and column numbers by which It Is Indexed. 


Evaluate and store a root of a quadratic equation 
ASS IGN , Rl= ( -B+SQRT ( B**2-4*A*C ) )/ ( 2*A ) ; 

The range field can be used to set values in a data element. 

ASSIGN, VECT0R2(NUMBER) = COUNT(NUMBER) 'NUMBER) « 1,10; 
Compute and store the scalar product of two vectors 
ASSIGN, D0T=0; 

ASSIGN, DOT = DOT + A(IND) * B(IND) ' I HD = 1,3; 

Character data can be stored in DEs created for character data 
ALLOCATE, TITLE-C32 

ASSIGN, TITLE = "R00T1 AND SCALAR PRODUCT"; 


ASSIGN can be used for a variety of purposes. 





38 If Statement (Condition Testing In Sequence Tables) 


The IF... EL SE • • • END I F (or IF... END I F ) block allows selective execution of sequence table 
statements. 


The IF statement. is used In sequence tables to a llow conditional execution of one or 

more statements , in Its simplest form, the IF block consists of an IF statement, one or 

more other statements, and END I F . 

IF, INUM>6; 

ASSIGN, INUM=6; 

END IF 

For Instance, the above sequence sets the value of data element INUM to 6 i f and only If 
It started with a value greater than 6. Logically, the condition specified In the IF 
statement Is tested to determine whether It Is true or false. If It Is true, the 

statement (s) following the IF statement are executed; If false, they are skipped until 

ENDIF (or ELSE) Is found. If an ELSE clause Is present, 

IF, INUM>6; 

ASSIGN, I NUM=6; 

ELSE 

ASSIGN, I NUM=0; 

ENDIF 

then the statements following ELSE are 
executed only If the condition Is false , 
and are skipped If It Is true. Thus, 
either of two blocks of statements can be 
selected, depending on the truth value of 
the condition, in the above Instance, INUM 
Is set to 6 If It started out greater than 
6, and Is set to 0 If It started out less 
than or equal to 6. Any number of 
statements can occur after IF and after 
ELSE. IF, ELSE, and ENDIF can appear only 
In sequence tables; they cannot be entered 
as directives for Immediate execution by 
the FDS Executive. Incidentally, the IF 
statement must be terminated with a 
semicolon. 


Ihe "condition" portion of an IF statement 
consists of two mathematical expressions and 
a relatio nal operator . The IF statement 
amounts to a construct of the form 

expression relation expression. 

The expressions can take any of the forms 
discussed In connection with the ASSIGN 
statement. They can Include addition, 
subtraction, etc., as well as parentheses and 
mathematical functions. They may refer to 
data elements, with or without subscripts, as 
well as numerical constants. The relations 
Include equal ( * ), not equal ( <> or >< ), 
less than ( < ), greater than ( > ), less 
than or equal ( <* or s < ), and greater than 
or equal ( >= or *> ). Thus, very complex 
tests are possible, although It will usrally 
be advantageous to keop things simple. 

38-2. The function of IF blocks Is 
illustrated by a flowchart. 
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IF , condition 
(statements) 
ENDIF 

' range ' 

• • -L 

IF , condition 
! (statements) 
ELSE 

(statements) 

ENDIF 

'range ' 

• • • i. 


38-1. The IF statement can be used 
with or without an ELSE-clause. 



Th« IF...FLSE...FNDIF ( 0 r IF. ..ENDIF) block allow* conditional 
execution of statement* In a sequence table. 

IF,aandilLQfl ’range •..•x 
(statements ) 

ELSE 

(statements ) 

END I F 


If blocks may, iie In a iLlerarcJilfcal .fashion- Thus, the sequence 


IF, J<10; 

L IST,XYZ-ST 

Symbol 

Operation 

END 1 F 
ELSE 

< 

less than 

LIST,WXY-ST 

ENDIF 

> 

greater than 

Is allowed. In this sequence, the Inside 
IF block Is executed only If 1 equals 1. 

<- 

less than or equal 

If 1 Is not equal to 1, the ELSE clause Is 
executed (l.e., the statement "L 1 ST, WXY-ST" 

-< 

m n m ii 

Is executed). Notice that, If 1 Is 1 and J 
Is 10 or greater, nothing Is LISTed. 

>- 

greater than or equal 

Interpretation of such a construct may be 
easier If It Is written In Indented form to 

- > 

ii ii m n 

show Its hierarchical structure. 
IF, M; 

- 

equal 

IF, J<10; 

L 1 ST,XYZ-ST 

>< 

not equal 

ENDIF 

ELSE 

<> 

li ii 

L 1ST, WXY-ST 


relational operators 

END 1 F 

38-3. Several 

can be used in 

the "condition" portion 


of IF statements. 

An IF statement can also have a "ranac" . For example, the statement 
IF,MATRIX(I )>0 f I* 1 ,10; 

could be used to test all values of a 10-element array. The condition Is true only If 
all Individual tests are true . Thus, In the above case, a. I 10 elements of MATRIX must 
be greater than zero or the condition Is false. Up to four range specifications can be 
used. Their form Is the same as that discussed In connection with the ASSIGN statement. 


CONDITIONAL 

EXPRESSION* 

EQUIVALENT ARITHMETIC EXPRESSION 
(assume I=2,J=2,K*3) 

TRUTH VALUE 

I * J 

2 « 2 

TRUE 

I = K 

2 * 3 

FALSE 

K J 

2< 2 

FALSE 

K K 

2< 3 

TRUE 

I <■ J 

2< * 2 

TRUE 

I > J 

2 > 2 

TALSE 

K > I 

3 > 2 

TRUE 

I >■ J 

2 >■ 2 

TRUE 

I<> J 

2 0 2 

FALSE 

I<> K 

2 0 3 

TRUE 

I*J> • K 

4 >» 3 

TRUE 

I**J “ (K-1)**J 

4 = 1 

TALSE 


38-4. The truth value of a condition is determined by computing the numerical values 
of the expressions and applying the relational operator. 
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39 DO LOOP Statement (Iteration In Sequence Tables) 


The DO LOOP block Is used for conditional looping In sequence tables. 


The DO LQOP^LQQP END block allots Iterative execution of slaicmenis adjunction .Qf _a 
spec 1 f led cond 1 1 Ion . Thus, the sequence 

ASSIGN, 1*1; 

DO LOOP, WHILE, l<*10; 

ASSIGN, ARRAYd )«l; 

ASSIGN, 1*1+1; 

LOOP END 

causes the last two ASSIGN stalements to be executed 10 times, with the data element I 
taking on the values 1, 2, 3, ... 10. The loop has the effect of setting each element 
of ARRAY to Its Index position (ARRAYd) * 1, ARRAY(2) ■ 2, etc.). This Is en example 
of a WHILE loop. In which the loop Is repeatedly executed while the specified condition 
Is true. The test Is performed each time the loop Is entered. When It is found to be 
false, the loop Is exited, and those statements which follow LOOP END are executed. DO 
LOOP (and LOOP END) statements can be used only In sequence tables. DO LOOP statements 
must end In a semicolon. 


DO LOOr, WHILE .condition 
( s t a t ements) 

LOOP END 

'range ' 

• • i 

DO LOOP. UNTIL, condition 
(statements) 

LOOP END 

'range ' . 

’ • * i 


39-1. The DO LOOP statement has both WHILE and UNTIL forms. 


in .Ihe -UNT 11 form of UQ LQQP^ the te s t i s aer fanned at the j&nd of the leap. Compare the 
sequence 

ASSIGN, 1*1; 

DO LOOP, WHILE, l>*10 
ASSIGN, 1*9999; 

LOOP END 

with the sequence 

ASSIGN, 1-1; 

DO LOOP, UNTIL, I >-1 0 
ASSIGN, 1*9999; 

LOOP END 

When the WHILE sequence Is executed, I Is given as value of 1, which Is not changed by 
the DO LOOP. This Is because the condition l>«10 Is false and the statement within the 
DO LOOP block Is not executed. On the other hand, the UNTIL loop Is executed exactly 
once. Since no tes+ Is performed until after the stntamnrt within the loop Is executed, 
I takes on the value 9999. When the test Is then applies. It Is found to be true , which 
causes the loop to be exited . As the words suggest, WHILE causes Iteration as long as 
the condition remains true , and UNTIL causes Iteration unt LI the condition becomes true. 
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The DO LOOP block allows conditional looping within a sequence table. A collection of 
sequence table statements can be repeatedly executed WHILE specified conditions a^e met 
or UNTIL specified termination conditions are satisfied. 

DO LOOP.WHILE.candltlQn ’range '...i 
or DO LOOP .UNTIL.CQnd It Ion ’range '...i 
(statements) 

LOOP END 


DO LOOP, WHILE, condition 


DO LOOP, UNTIL, condition 




39-2. WHILE and UNTIL loops differ in the time at which test is applied. 


As In the IF statement, the condition In a DO LOOP statement _can_LAvolve a ”ranqe” . To 
be considered true, the condition must be true across all values of the Index variable. 
For example, the loop 

DO LOOP, WHILE, ARRAY (I )>0 *1=1,5; 

(statements) 

LOOP END 

w i I be skipped. If any of the first five elements of ARRAY Is nonpositive. Up to four 
range specifications can be used. 


DQ LOOP blocks can be nested with o +' er DO LOOP blocks or with. LF. blocks . Thus, a 
sequence such as 

ASSIGN, 1=1; 

DO LOOP, WHILE, l<=10; 

I F,B( I )>A( I ); 

ASSIGN, A( I )=B( I ); 

END IF 

ASSIGN, 1=1+1 ; 

LOOP END 

Is possible. This sequence causes the first 10 elements of A to take on a value which 
Is the greater of: (1) their Initial value, and (2) the corresponding value In array 3. 

When blocks are nested In this way. It is Important to recognize that the Inside block 
must be closed first. Thus, the following ’’over I appi ng” structure Is 1 1 leg al . 

DO LOOP, WHILE, l<6; 

I F, J=0; 

(siatements) 

LOOP END 
END IF 
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40 BREAK. DLQG. FORMAT. MESSAGE, NEWS Commands (Miscellaneous FDS Commands) 


The commands BREAK, DLOG, FORMAT, MESSAGE, and NEWS allow the user to obtain system 
status, transaction log, mixed data format displays, and current news Information, and 
to communicate with other users. 


The BREAK C ommand causes FDS to display the current funct lQnal__statu£ of_a_l 1 , act i v e . £QS 
tasks associated with the current user . The current contents of the execution stack are 
displayed to the user. The appropriate prompt symbol, task name, and the names of any 
tables being processed are displayed. 

TJifi. DLQG command j^Iqks the user to display all .or par t-af... the. -user's, , Trans action log 
file . The transaction log Is a "circular” file which has a predetermined size. As new 
transactions are added, the oldest ones are thrown away in order to make room for the 
new Information. Each FDS prompt, each user Input, and each error message. Is placed In 
this file, along with date and time tags. The user can display all transactions for the 
current day on the terminal 
DLOG 

or on the system line printer 
DLOG-P 

or can specify starting and/or ending dates or times. For example, the command 
DLOG, 12/ 18/ 83, 14/23/00 

causes all stored transactions, which occurred on 18 December 1983, after 2:23 P.M., to 
be displayed. Date fields take the form month/day/year. The current day Is assumed. If 
date Is omitted bu+ time Is given, as In 
DLOG,, 14/23/00 

Time fields take the form hour/m! nute/second . If start time Is omitted, but other date 
or time Information Is given, time 00/C /00 (midnight) Is assumed. If end time Is 
omitted, 23/59/59 Is assumed. If a starf date Is given, but no end date is given, the 
start date Is assumed to be the end date. Thus, the command 
DLOG J 2/ 17/ 83,,, 14/23/00 

displays all stored transactions from the start of the day on 17 December 1983 through 
2:23 P.M. on the same day. 


12/18/83 

08/04/24 

* INFO *EX*XMINIT01* 53* 

FDS SIGN0N 

COMPLETED, FDS VERSION IS 6C 

12/18/83 

08/04/24 

% : 

12/18/83 

08/04/45 

GET.EXPL-PD 

12/18/83 

08/04/46 

% : 

12/18/83 

08/04/59 

TOC 

12/18/83 

08/05/01 

O' 

to • 

12/18/83 

08/05/27 

EDIT, ,0MS2-IT,GPMP 


40-1. The transaction log contains a time-stamped record of recent FDS prompts and 
user inputs. 

Th e FORMAT command displays current definitions of all, or selected, mixed data formats . 
The mixed data type Is used when elements of more than one type are contained In a 
single data element or DRDE. While data types may be combined, they must be combined 
according to an existing format definition. These definitions are numbered, and may be 
displayed usinq the FORMAT command. Thus, 

FORIu J,M31 ,M33 

displays the contents of format definitions 31 and 33, while 
FORMAT- P 

displays all current format definitions on the system line printer. 
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The BREAK command displays the current functional status of all active FDS tasks 
associated with the current user, 

BREAK 

The DLOG command displays all or part of the user’s transaction log file. 

DLOG-devlce ID, start date, start time, end date, end time 

The FORMAT command displays current mixed data formats. 

FORMAT-dev Ice ID, format number,... 

The MESSAGE command transmits a message to one or more other users. 

MESSAGE, access code (s) ." text " 

The NEWS command displays system status Information which has been placed In a NEWS file 
by system support personnel • 

NEWS-devIce ID, start date 

Ihs MESSAGE CQmfnand-fl Ufl wa. tiie..user_ to t ransmit .a-message. -la .any, other- EDS .user. The 
message will be displayed for the reclplent(s) with the date and time of transmission 
and the originating user's access code. If a recipient is currently logged on, the 
message will be displayed on that user's terminal just prior to the next Executive level 
(5f) prompt. If the recipient Is not logged on, the message Is retained and 
automatically presented when the user next logs on. Once a retained message has been 
displayed. It Is purged from the system. 

__ ‘ 

DLOG-device ID, start date, start time, end date, end time 
FORMAT-device ID, format number,... 

MESSAGE-access code(s) / text" 

NEWS-device ID, start date 

40-2. Syntax of miscellaneous FDS commands. 

Ihe_MESSAGE command specifies the message text, and may specify the access code(s) of 
one or more recipients . For Instance, the command 

MESSAGE, AY, "MEETING HAS BEEN POSTPONED TO 3:30" 
transmits a message only to user AV. If no access code Is given, 

MESSAGE, , "SYSTEM WILL BE DOWN 3:30-4:00 P.M." 
it Is transmitted to all users. The user should keep In mind the message retention 
feature. The above message Is clearly unsatisfactory. A user who next logs on a week 
later may not recognize this message as Inapplicable at that time. Multiple recipient 
access codes are allowable, as In 

MESSAGE, AW, CW, "HAS ANYONE UPDATED THE 
CONTINUE: OMS-2 INTERFACE TABLE YET?" 

This command takes advantage of the multiple line facility available In all commands. 
Note, however, that the message will be displayed In a single line 
MESSAGE FROM CY, 12/ 18/83 02/16/27 
HAS ANYONE UPDATED THE OMS-2 INTERFACE TABLE YET? 
unless Control-C Is used to break It Into multiple lines. The message text Is limited 
to 122 characters. Including Control-C characters. 


IhftJQS command displays system status, inf ormat Lon Elacfid.-iiL._a. NEMS.J. i Ijb 

by system support personnel . This facility Is used primarily to convey Information 
about the system Itself, Including updates to system software and to Master Data Bases. 
If no device ID Is specified, 

NEWS 

the Information Is displayed on the user's terminal. If the line printer device code Is 
specif led, 

NEWS-P 

the news Is printed on the system printer. If no date Is specified (as In the above 
commands), the entire news file Is displayed. To obtain only news entered on or after a 
specified date, that date Is added to the command In the form month/day/year. 

NEWS, 12/ 18/83 
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41 


AUTOMATED DOCUMEN T . PRODUCT 1 QN 


FDS supports automated production of standard documentation. 


A major function of FDS Is I t s support, of ^toimtod .document production* Briefly, FDS 
accomplishes this by substituting computed and user-provided Information for "holes", or 
placeholders. In a predefined text document. The overall document production process Is 
fairly complex. Involving five groups of personnel, throe computers, and a large number 
of procedural steps. From the user’s point of view, though, the process Is fairly 
simple and automatic. 


In automated document product J o n ,., t he-iiser's job. Js.Jta. pr o vide t he I nformation w hich 
changes from mission to mission . Each standard document (e.g., CFP) has a large amount 
of Information which remains the same across all, or many, flights. Only the changeable 
Information needs to be provided In order to produce documentation which fully describes 
a unique mission. Support personnel have created a number of standardized document 
segments, and have left spaces ("holes") to show where user-prov Ided Information goes. 
The information already provided by the support personnel includes format 
specifications, units of measure (conversion is automatic), and other data required to 
fill each "hole". The user must only Indicate to FDS the values, or where the values 
are to be found, so that FDS can automatically fill In all the "holes" In a 
document/ segment . 


Although the user’s part In document production is relatively simple, a clear 
understanding of the process requires an awareness of_several components . For each 
DOCUMENT/SEGMENT, there Is a FORM, which consists of the basic text (and tables, etc.) 
of the segment, with placeholders showing where values are to be provided by FDS. These 
forms are provided by system support personnel. For each document/segment, there Is 
also a DATA DESCRIPTOR TABLE (DDT) provided by support personnel. This table Indicates 
the name of each missing value or set of values In the Form, and provides Information 
about format, units of measure, etc. Although this Information is actually stored In 
FDS Linkage Tables, It Is convenient to think of it as a separate entity; It Is not 
under user control, as Is the rest of the Linkage Table Information. The DOCUMENT 
PROCESSOR uses this DDT Information, and Information provided by the user, to construct 
a finished document. The Document Processor Is an X Processor, and Is executed In the 
same way as any other X Processor, using a PERFORM command which specifies an Interface 
Table. 


The components w hich t he user must provide are.the-- Link age. T abl e ., and t he„lnterface. 
Table . The LINKAGE TABLE (LT) Is the user’s way of Identifying, for the system, the 
values which are to be placed In the "holes" In the Form. Because the Document 
Processor (DOC) Is an X Processor, It obtains Its basic Information from an Intprfarp 
Table. In this case, the IT Identifies the name of the Document/Segment, name of the 
Linkage Table, and other Information necessary for the DOC to proceed. 
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FDS supports automated production of standard documents with minimal effort by the user. 
To produce a document, the user must provide the values (or their locations) which are 
to be placed In the "holes" In a standard Form. This process utilizes Forms and Data 
Descriptor Tables (both provided by support personnel), a Documentation Processor 
(DOC-XP), and Linkage Tables and Interface Tables (both provided by the user). 


Form: 

Text, tables, etc., with "holes” to show whero FDS-supplled values are to be 
placed. These Forms are provided by support personnel. 


Data Descriptor Table (this Information Is actually stored as part of the default 
Linkage Table): 

A description of the data Items which are to be placed In the "holes”. This 
table provides a name for each data Item, Information about Its format, and 
unit of measure (where appropriate). The order of the entries In the DDT 
corresponds +0 that of the "holes” In the form. DDTs are provided by support 
personnel . 


Linkage Table (user-modifiable portion): 

A table which Indicates the values which are to be placed In the "holes”, or 
the names of data elements or DRDEs In which the values are stored. This 
table Is the user f s means of caurlng appropriate values to appear In the 
automatically produced document. 


Interface Table: 

An ordinary Interface table (for the DOC X Processor) which tells the Document 
Processor the name of the document/segment, linkage table, etc., needed to 
prepare a finished document/segmont. 

Document Processor: 

An X-Processor (called DOC) which performs the document preparation. DOC 
obtains the Form and uses Information In the DDT and LT to f 1 1 ! !r. a! I the 
"holes”. The resulting document/segmant can be displayed for user review, and 
can be deleted or stored for actual production. 


41-1. Production of a finished document/segment requires several components. 
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42 AN EXAMPLE OF AUTOMATED DOCUMENT PRODUCTION 


The user controls the behavior of the Document Processor by making appropriate entries 
In a Linkage Table and an Interface Table. 


Ero paratlon of a Linkage Table is the_maln..user. .activity Involved In document 
production . In almost all respects, this Is Just like preparing an Interface table. 
Suppose, for example, that the user wishes to prepare a linkage table called EXAMPLE, 
starting with the default Linkage Table for a document called CFP1, segment LIFT. The 
user would type In the command 

EDIT,, EXAMPL E-LT, CFP 1 L I FT 

Just as In Interface table editing, the editor starts In the Incomplete mode unless the 
default LT Is complete. In the LT, the parameTers are the names of the Items of 
Information which are to be substituted for placeholders ("holes”) In the form. As In 
an IT, the user can specify the actual value to be used, or can specify the name of a DE 
where the Information can be found. Thus, In response to an editor prompt, the user 
could type In an actual value 

1 , LS ITET=&1 
<&1 :”KSC” 

or the name of a data element which contains the value 
<&1 :S ITE 

When arrays are required, the whole set of values can be typed In, or the name of a DE 
containing the whole set can be provided. The user can also Indicate a particular 
position In an array. Assume, for example, the lift-off time Is ordinarily found In 
element 7 of the first row of the flight state vector. Then, the user might respond 

2, TL0=&1 

<&1 :RE$ULT( 1 ,7) 

In order to point the document processor to element (1,7) of the RESULT DE. If TLO 
required more than one value, the required number of values would be taken from RESULT, 
starting In location (1,7). 


The user mustaiso provide an Interface, Tabie^hich DOC uses to find all the 
Iniormatloa Jt needs, to write to the, correct file, etc . Thus, the user might construct 
an IT called EXAMiT, using ordinary procedures for IT editing. The user must state the 
name of the document (here It Is assumed to be CFP1), the segment name (LIFT), Linkage 
Table name (EXAMPLE), output test file name (OUTTEXT) and other Information. A portion 
of this dialogue might be: 

ED IT, EXAMIT- IT, DOC 

1 , DOCUMENTS 1 
\&1 :"CFP1" 

2, SEGMENTS 1 
\&1 :"L I FT" 

3, LTABLE=&1 
\&1:EXAMPI F 
4 f FILENAME &&1 
\&1 : OUTTEXT 

For more detail about the use of DOC, the user should consult the X Processor User 
Reference Manual. 


Qnce the LT and IT have been constructed, the user simply executes DOC . The appropriate 
command Is 

PERFORM, DOC, EXAM IT 

DOC performs the document construction, and gives the user an opportunity to screen the 
results. When the user Is satisfied, tne output text can be stored for transmission to 
the Xerox Word Processing System, where final output will be accomplished. 
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An example Illustrates the Information used by the Document Processor to produce 
documents In an automated way. For further Information, the user Is referred to the 
X Processor User Reference Manual section deal Ing with the DOC processor. 


I 

I 


Form (assume this document/segment Is called CFP1/LIFT): 

Lift-off from [ H occurs at [ ] seconds after solid rocket booster (SRB) 
Ignition (MET s [ ] seconds) after which a vertical rise to tower clearance 
phase Is Initiated, ending at a relative velocity of [ 3 fps (MET = [ 2 
seconds) • 


Data Descriptor Table (for document/segment CFP1/LIFT): 

(This Information Is actually stored In the Linkage Table, mostly In the 
"extended prompt” records* See X Processor User Reference Manual for more 
Information.) 


name 

typjg 

format 

units 

prompt taxt 

LSITET 

C4 

A3 

- 

LAUNCH SITE 

TLO 

R 

T0:0:0: 1 

- 

TIME OF LIFTOFF (GET) 

TL01 

R 

TO :0:0:3.1 

- 

TIME OF LIFTOFF (GET) 

RELVEL 

R 

13 

FT/S 

RELATIVE VELOCITY 

TCLNCE 

R 

TO :0:0:3.1 

- 

TIME OF TOWER CLEARANCE 


Linkage Table (assume this Is called EXAMPLE-LT): 

1, LSITET="KSC” 

2, TL0=RESULT( 1 ,1 ) 

3, TL01 =RESULT( 1,2) 

4, RELVEL=RESULT(7 ,3) 

5, TCLNCE=RESULT( 1 ,3) 


Interface Table (assume this Is called EXAMIT-IT) 

1 , DOCUMENT* "CFPI" 

2,SEGMENT=”L I FT" 

3 , LTABL E= EX AMPL E 

4 , F I LENAME=OUTTEXT 


Date Element (called RESULT. This Is just an example): 

Assume that RtSULT( 1 ,7) =3.0 
Assume that RESULT(2,7)=3.1 
Assume that RESULT(3,9)=20.0 
Assume that RESULT(3,7)=3.8 

Finished text (stored by DOC In OUTTEXT-DF): 

Lift-off from KSC occurs at 3 seconds after solid rocket Dooter (SRB) Ignition 
(GET=3.1 seconds) after which a vertical rise to tower clearance phase Is 
Initiated, ending at a relative velocity of 20 fps (GET*3.8 seconds). 

42-1. An example shows how the various components are used by the Document Processor to 
produce the finished document. 
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APPENDIX A — MATHEMATICAL FUNCTIONS 


In context In which mathematical functions may be used (e.g., ASSIGN command), any of 
the functions listed below are available. The user should be aware of a peculiarity of 
the operating system. When a function error occurs (e.g. # ATAN(0 # 0)), no lnte r rupt or 
error message to the user terminal occurs. The system returns a default function value 
and writes an error message only to the system console, This should be kept In mind 
when debugging operations Involving functions. 


Function 

Resu 1 t 

Argument (s) 

Number of 


Name 

Type 

Type 

Ar guments 

Operation 

ABS 

R 

R 

1 

Absolute val ue 

ACOS 

R 

R 

1 

Inverse cosine 

AINT 

R 

R 

1 

Truncate fraction 

ALOG 

R 

R 

1 

Natural logarithm 

ALOGIO 

R 

R 

1 

Base ten logarithm 

AMOD 

R 

R 

2 

Modulo 

AS IN 

R 

R 

1 

Inverse sine 

ATAN 

R 

R 

1 

Inverse tangent 

ATAN2 

R 

R 

2 

Inverse tangent 

COS 

R 

R 

1 

Cos I ne 

DABS 

D 

D 

1 

Absolute val ue 

DATAN 

D 

D 

1 

lnve r se tangent 

DATAN2 

D 

D 

2 

Inverse tangent 

DBLE 

D 

R 

1 

Convert to double 

DCOS 

D 

D 

1 

Cos I ne 

DEXP 

D 

D 

1 

e ** x 

DINT 

D 

D 

1 

e ** x 

DLOG 

D 

D 

1 

Natural logarithm 

DL0G10 

D 

D 

1 

Base ten logarithm 

DMOD 

D 

D 

2 

Modulo 

DSIGN 

D 

D 

2 

App 1 / sign 

DSIN 

D 

D 

1 

Sine 

DSQRT 

D 

D 

1 

Square root 

DTAN 

D 

D 

1 

Tangent 

DTANH 

D 

D 

1 

Hyperbol Ic tangent 

EXP 

R 

R 

1 

e ** x 

FLOAT 

R 

1 

1 

Convert to real 

1 ABS 

1 

1 

1 

Absolute value 

ID 1 NT 

1 

D 

1 

Convert to Integer 

1 F IX 

1 

R 

1 

Convert to Integer 

ISIGN 

1 

1 

2 

Apply sign 

MOD 

1 

1 

2 

Modulo 

SIGN 

R 

R 

2 

Apply sign 

SIN 

R 

R 

1 

Sine 

SNGL 

R 

D 

1 

Convert to real 

SQRT 

R 

R 

1 

Square root 

TAN 

R 

R 

1 

Tangent 

TANH 

R 

R 

1 

Hyperbolic tangent 


APPENDIX B — SIZES AND DIMENSIONS 


ilfifl) 

Abel'* act length 
AWA size 

Data element column length 
Data element size 
DWA size 

Entry number In fable 

Execution stack levels 

Interface/Linkage/Sequence table slz 

MDB/PDB size 

MESSAGE command text 

Messages queued ner user 

Nested repeat fields 

NOTE command text 

PDBs per user 

Sequence Table entries 

Subscript of da+a element 

TOC entries (AWA or data base) 

X batch jobs per user 
X batch jobs queued (all users combi 


Limit 

256 bytes * 256 characters 
32768 bytes = 8192 words 
1024 components 
4096 bytes « 1024 words 
8192 sectors (2 Mbytes) 
range 1-32767 
8 

4096 bytes * 1024 words 

32767 sectors (8 Mbytes) 

122 characters 

assignable by user 

4 levels of nesting 

1600 characters 

assignable by user 
(also limited by disk space) 
226 

range 1-2047 
630 

assignable by user 
) 50 
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APPENDIX C ~ GLOSSARY 


abstract — text associated with a given file or processor which contains description of 
the file contents or processor function. The user Is responsible for creating and 
updating abstracts for files In PDBs. 


access code — a two-character code by which a user logs on, and by which ownership of 
PDBs Is Indicated. 


Active Work Area (AWA) — an area of memory and disk storage utilized as working space 
for the construction and manipulation of data. An AWA Is automatical ly al located to 
a user at sign-on and purged from the system at sign-off. 


automatic (execution mode) — a mode In which FDS Interactively executes the statements 
In a Sequence Table without requiring user approval at each step. 


batch (execution mode) — a mode In which FDS executes the commends In a Sequence Table 
at some later time, as the system's processing load al lows. 


character (data ty pe) — a data type consisting of text strings which occupy 4, 8, 16, 
32, or 64 bytes (characters) of storage. 


command — a user-specified Instruction to FDS. Commands which are executed Immediately 
are called c irect I ves . Commands which ^ re stored In sequence tables for later 
execution are cal led statements . 


data base — a set of files stored on disk which are relatively permanent, such as 
personal data bases or master data bases. 


Data Element (DE) — a col lection of related processor Input and output variables 
grouped together Into a single file and stored under a user-defined name. Data 
elements can be stored In 1 he AWA, a PDB, or an MDB. 


device ID — a code which can be added to many commands to specify the device on which 
generated output Is to be displayed. The only al lowoble device code Is (-P), which 
Indicates the system printer. 


directive — see command. 


Disk Resident Date Llement (DRDE) — A "data element" which Is potential ly too large for 
the memory-resident portion of the AWA, and which Is therefore declared to be 
disk-resident. 


disk work area (DWA) — the disk-resident portion of the AWA. 


— A soeclal X Processor whose functlor 
on Information computed In designing a fllfht. 


Is to produce documents based 


Cl 


document/segment — A portion of a standard document which can be produced using FDS 
Each such portion Is specified by giving Its document name and segment name. 


ed 1 tor — A portion of the Executive which al lows the user to construct and modify 
tables. 


Execut I ve — that part of FDS which communlca+os with the user and through which the 
user manages files. Invokes the ed ! tor and Initiates processor activity. 


1J le — an organized, named collection of Information. 


Interface Table ( IT) — A table which contains Input/output Information for use by an 
X Processor. 


Linkage Table (LI) — A table which contains Information on the values which are to be 
placed In an automatical ly produced document. 


Master Data Base (MDB) — collection of permanent files which provide a source of data 
to all FDS users. The M)B supplies basic data on a read-only basis. 


Personal Data Base (PDB) — A col lection of files "permanentl y" stored on disk by a 
user. 


remote job entry — Submission of a job to a computer, from a remote location, for 
subsequent processing and return of output to the originating location. 


semi-automatic (execution mode) — a mode In which rDS Interactively executes the 
statements In a Sequence Table, stopping at each step for user approval or other 
action. 


— a group of FDS commands stored for later execution. 


s 1 gn-of f — process by which communication Is ended with FDS, resulting In the AWA data 
being purged. 


s lgn-on — process by which communication Is established with FDS, resulting In the 
allocation of the AWA. 


statement — see command. 


table — a f 1 1 e of one of the following types: Interface table, linkage able, sequence 

table, Y-data table. 


Table-Qf-Contents (TQC) — a directory of the data contained In the AWA or In various 
data bases. It Includes the names and attributes of all data elements and tables. 


Job — The process, events, and output associated with the execution of a Sequence 
Table In the batch mode. 


Processor — A computational support routine available to the FDS user for either 
Interactive or batch execution. X Processors reside In FDS and perform simulations 
at an appropriate level of detail for preliminary planning and development of a 
Conceptual Flight Profile. 


Y Processor — a computational support routine which resides on a separate computer from 
FDS and is available for execution via remote Job entry. Y Processors perform 
highly detailed simulations compatible with de w elopment o* an Operational Flight 
Prof 1 1 e. 
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APPENDIX D — TIME DATA TYPE 


1 . Base Date; 

- User specified as year, month, and day of month 

- Defined to be zero hours, zero minutes, zero seconds, Greenwich 
zone time on the user-spec I f led year, month, day of month 

- Base date Is the Instant In time at which the FDS Inertial reference 
axis systems (MEE, TEE, and TEG) are defined (l.e, the Precession 
matrix, Nutation matrix, and Initial right ascension of Greenwich 
are computed) 

- User specifies the Base Date for a session by executing the BASTM processor 


2. lime References : In FDS-2 there are four time references available for user Inpjt 

and display of event times . They are defined as f I lows: 

IET * Internal Elapsed Time - It Is an event time which Is measured from 
the user defined base date . All Internal FDS time tags (e.g., 
posltlon/veloclty state vector or attitude event time tags) are stored In 
this measure. The time Is expressed In days, hours, minutes, and seconds. 

MET * Mission Elapsed Time - It Is an event time which Is measured from a 

user defined reference time. The time Is expressed In days, hours, minutes, 
and seconds. 

PET * Phase Elapsed Time - It Is an event time which Is measured from a 

second user defined reference time. The time Is expressed In days, hours, 
m,‘nutes, and seconds. 

GMT c Greenwich Mean Time - It Is an event time which Is measured from the 

beginning of the year of base date . The time Is expressed In day of year 
and time of day. The day of year Is an Integral day count from the 
beginning of the base date year. The day count Is negative In the year's 
prior to base date year and continues to Increment positively In the years 
after base daie year. Day o* year does not recycle to one at the end of 
tase date year when time lag Is Deyond that year. 

Time of day Is expressed as hours, minutes, and seconds In Greenwich zone 
time. For example. If the base date year Is 1980 and the date to be 
expressed In GMT Is Dec. 1, 1980, noon GMT, the GMT Is 366:12:0:0. If the 
date Is Jan. 1, 1981, noon GMT, the GMT Is 367:12:0:0. If the date Is 
Dec. 31, 1979, noon GMT, the GMT Is -1:12:0:0. There Is no zero day of 
year. 


3. Specification of MET and PET Reference Times : 

- The user must specify the MET and PET reference times (l.e., the MET * 0 
and PET * 0 times) In the IET reference. 

- The user can specify and change MET and PET reference times 
of each other utilizing the BASTM processor. 


I ndependent I y 


Him. -lyflfi .t a r Inter, Lace Table Prcmpt Parameters and Processor Proms Is : The letter T 

deslqnatlnq the time typo is u‘>od io Identify It In the Processor Interface Tabic 
and Processor Prompt Table, The Input user syntax for time Is ± d.d:h.h:m.m:s.s 
where the sign applies to the total time value. Each number Is any numeric data 
type. Colon Is the cnly valid separator and all colons prior to the first number 
are required. 
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APPENDIX I 


INDEX 


This Is an Index of the terms and concepts used In this user guide. The numerical 
references are to page numbers. In cases In which one or two pages are especially 
relevant to the term or concept, tho.;e page numbers are underlined. 


Module 17 has not been Indexed 

Modules 41 ff have not been Indexed 


Special. Symbols 

1 (In range specification) 

75- 77, 79 

@ (IT output value symbol) 

24 , 46 

& (missing value symbol) 

24 , 44-45, 47, 49 

&LABEL (missing value symbol) 

24 , 44-45, 46, 48, 52 

\ (prompt symbol for IT editor) see prompt symbol, \ 

\ (to switch to IT editor update mode) 

43 

, (to separate fields In commands) 

32, 66, 69 

= (equal) 

76- 77 

= (IT Input value symbol) 

24 , 46 

=§ (IT Input/output value symbol) 

46 

=< ( less than or equal ) 

76-77 

=> (greater than or equal) 

76-77 

! file names 

24 

!! filenames 
12, 24 


> (greater than) 
76-77 


■ 


> (prompt symbol for YDT editor) see prompt symbol, > 

> (to switch to LT editor update mode) 

43 


>= (greater than or equal) 

76-77 

>< (not equal ) 

76-77 

< ( less than) 

76-77 

< (prompt symbol for LT editor) see prompt symbol, < 

< (to switch to YDT editor update mode) 

43 


<= (less than or equal) 
76-77 


<> (not equal ) 

76-77 

% (prompt symbol for Executive) see prompt symbol, % 

% (to abort and return to Executive) 

41, 44-45. ii, 72-73 

... (ellipses In command definition) 

32 


S (to skip entry In semiautomatic execution) 1 

72-73 

S (prompt symbol for semiautomatic execution) see prompt symbol, S 

0 (prompt symbol for ST editor) see prompt symbol, 0 

0 (to switch to ST editor update mode) 

43, 52 

? (to obtain help) see also directive? 

M-45, 48, 52, 70, 72-73 

H (string literal delimiter) 

55, 66, 69 

; (to terminate a command) 

35, 75-76, 78 

: (as part of prompt) see prompting 

: (In time data type) see Time data 


I 


12 


A 


abbreviation, of commands 
35, 71 

abend . see abnormal processor termination 

abnorma , rocessor termination 
38-39 

abort of a processor 
38-39 

abort of an editor 

40-41, 44-45, 51 

ABSTRACT command 
32, 35, 54 =11 

abstracts, of files, data bases, processors, etc. 
54-55 


access code 

20, 15, 54, 59-60, 62, 64, 69, 81 

accuracy of computation 
30 

Active Work Area (AWA) 

15, 21, 23-24, 28, 36-37, 40-41, 49, 53, 58-64, ^2-74 

Active Work Area allocation 

16, 15 

ALL mode (editor) 

42-41, 44, 46 

ALLOCATE command 

21, 29, 32, 52, 74-75 

APPEND command 

20-21, 32, 52=12 

application processor 
12 

arithmetic expressions 
74-76 


arrays 

16, 24-25, 70, 74-75 

ASSIGN command 

29, 32, 74r 71, 78-79 

altitude analysis 

4, 10-11 
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ATTRIBUTES command 
25, 32, Z fr- H 


attributes, of X Processors see X Processor attributes 

AUTOMATIC command 
32, 39, 12=21 

automatic execution mode 
15, 28, 38-52, 51 


BATCH command 

32, 39, 12=21 

batch execution 

12-13, 15, 26, 28, 30, 38-39, 51, 55, 57, 60, 72-73 

BREAK command 
32, 80-81 

break key 
38 


Cargo Integration Review 

5 

carriage return (see also Control -C) 

35, 44, 45, 55, 72-73 

categories of flights 

6 

CFP see Conceptual Flight Profile 

CHANGE command 

32, 49, 52, 65, fife, 71 

changing see modification 

character data (Cn) ...... see also string literals 

21 , 70, 74-75 

cl ass If 1 cat I on code 

20-21, 54-55, 58, 60, 69 


CLEAR command 

21, 28, 32, S2=ll, 65 


14 


clearing of screen 
34 

Command Processor 
12-12, 32 

commands 

21, 28, 32-33 

comments. In sequence table •••••• see help; NOTE statement 

communication among users 
80-81 

Conceptual Flight Profile (CFP) 

5-7, 10-13, 15, 26, 30, 82 

cond 1 1 1 ona I execut I on 
28, 76-79 

consumables analysis 

4, 10-11 

CONTINUE: (prompt) 

22, 55 

Control-C 
35, 55 

COPY command 

21 9 32, 6.4-JB5 

copying, of flies 
64-65 

CPU time limit 
73 

CREATE mode (editor) 

42=42, 44, 46, 52 

creation, of abstracts 
54-55 

creation, of data elements 
74-75 

creation, of personal data bases 
59 

creation, of tables 
40-42 

crew activity planning 

4, 10 

Crew Simulator Data Pack 
7 

Crew Training and Procedures Division (CTPD) 

5 

15 


CROSS REFERENCE command 
32, 68-69 

CRT display 
34 

CTPD see Crew Training and Procedures Division 

12 


data base 
20-21 

Data Descriptor Table (DDT) 

82-85 

Data Element (DE) 

lfi-19 20-22, 24-25, 47, 54-58, 60-66, 68, 70, 74-75 . 80, 83, 85 

data element name 
74-75 

data formats see Mixed data 

data management 

14-15, 17, 20 = 21 , 32 

data storage areas 

16=J7 


data type 

21 , 74-75 

date/time tag 
54, 64, 80 


DE 


see Data Element 


decimal point. In number 
25 


default Interface table 

22-22, 40-41, 46, 48, 71 


default I Inkage table 
40-41 

default values. In commands 
32 

default values, In Interface tables 
23, 48 

default values, of disk, CPU time, and print line limits 
73 

DELETE command 

21, 32, 42, 42, 62=22, 65 
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T 
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deletion, of files 
62-63 


deletion, of lines from table 
42 


deletion, of personal data bases 
59, 62-63 


device ID (-P) 

55-56, 60, 68-70, 80-81 


DF see Disk-Resident Data Element 


dimensions, of array 
25, 74 




directive 

22# 41-46, 57 


directive? (to learn syntax of a directive) 
44-42, 52, 72-73 


disk a I location 
26-37, 22 


Disk-Resident Data Element (DRDE) 

lfi-22, 24-25, 37, 47, 54-57, 60-62, 64, 66, 68, 80, 83 


disk storage 

16-18, 20, 36-37, 63, 73 


Disk Work Area 
36-22# 73 


display, of abstracts 
54-55 


display, of available processor names 
60 


display, of files 
56-57 


display, of names of available data bases 
60 


display, of names of outstanding Jobs 
60 


display, of system news 
80 


display, of system status 
80 


display, of table of contents 
60-61 


17 


display, of transaction log 
80 


display, of X Processor attributes 
2G-71 

DLOG Command 
32, 80-81 


DO LOOP statement 
28, 23=21 

document processing 

7, 12-15. 19, 22-23, 30-31, 


02 = 35 . 


document processing workstation 

21 


Document Processor (DOC-XP) 
23, 32=35 


document/segment 

23, 41, 54-55, 60, 68, 70-71, 82-85 

double precision data (D) 

21. 74 

duplication of lines In table see INSERT command 

duplication of tables ...... see COPY command 


EDIT command 

32, AT, 43, 52, 57, 65 

editing of tables 
13-15, AQ-A5 

editor abort 
40-41 

editor directives and responses 
44-45 

editor modes 
42-43 

ellipses, In command definition 
32 

ELSE 

28, 76-77 
END IF 
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28, 23=21. 79 


entry number see also span 

24, 2fi, 43, 46, 52, 56, 66, 70, 72 

errors 

38 

example problem, In user guide 
2-3, flr2, 10-11 

execution, conditional 
76-77 

execution, of sequence tables 
72-73 


execution, of sequence table, at sign-on 
72-73 

execution, of X Processors see PERFORM command; X Processor execution 

execution stack 
80 

Executive 

12-13, 14-15 . 17, 19, 21, 28, 30-33, 36-37, 40-46, 62, 81 

EXIT command 

32, 40z41, 45, 49, 53 

expllclf editor Invocation 
40, 43 

expressions, mathematical 
74-76 


extended prompt 
44 


file 

20-21 
file names 

17, 21, 59, 62, 64-65, 68-69 

file types see also classification codes 

18-19 . 21, 58, 60, 62, 65, 68-69 

FIND command 
32, 6£b62 

fixed point see Integer data 

flight design process 
4-7 


floating point see real data 
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forms (for automated document production) 
62-85 

FORMAT command 

fi2 

free data (F) 

21, 57, 70, 74-75 

functions, mathematical 
74-75, Appendix A 


2 

General Purpose Maneuver Processor (GPMP) 


16 


GET command 

20-21, 28, 32, 37, 58-59 . 63, 65 

glossary, of user guide 
2, 3, Appendix C 


hardccpy device, at terminal 

11 

hardware 

12=11 

help (tutorial aids, commenting, etc.) 
44-45, 46, 51, 72-73 

HP21MX computer 

12-31 


IF statement 

28, 76-77 . 79 

Implicit editor Invocation 
22, 42, 49 

INCOMPLETE mode (editor) 
42-43 . 44, 46, 48, 52 

Incomplete values 

23-24 . 40, 42-44, 46, 72 


Index, of user guide 
2, 3 






Inrormatlonal messages (INFO) 

Initialization, of data elements 
74-75 

Input and output variables 
24-26, 46, 70-71 

INSERT command 

21, 32, 52, 65, 66-67 

Insertion, of lines In tables 
42, 67 

Integer data (I) 

21 . 74 

Interactive execution 

12-13, 15, 26, 72-73 

INTERDATA 0/32 computer 
iC-31 

Interface Table ( IT) 

10-12, 20-21, 22-25 . 26-27, 41, 54-56, 60-62, 64-60, 70-71, 02-05 

Interface Table editing 

14, 22-23, 40-43, 46-49 . 04-05 

IT see Interface Table 

Iteration, In ASSIGN statement 
75 

Iteration, In sequence table execution 

20, ZflrZa 


Job limits 
73 


keyword see parameter keyword 


line pr I nter 

29, 55-56, 60, 60, 70, 73, 00-01 
Linkage Table (LT) 

10-12, 20-22, 41, 47, 54-56, 60, 62, 64, 66-60, 02-05 


Linkage Table editing 
14, 40-43, 04-05 
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LIST command 

29, 32, 45 , 49, 52, 56-57 . 71 


logging on see slgn-on 

LOOP END 

28, 76-79 

looping see Iteration 

LT see Linkage Table 


M 

manual execution mode 
15, 12 

Master Data Bose (MDB) (MO) 

16-12, 18-21, 28, 54-55. 58-60, 62, 68, 73, 81 

Master Data Base names 
17 

mathemat I ca I express I on? 

74-76 

mathematical functions 
74-75, Appendix A 

MD see Master Data Base 

MDB see Master Data Base 


merging, of tables 
66-67 


MESSAGE command 

messages from system 
38-39 

MISSING mode (editor) 

42-43 P 44, 46, 49 

missing values 

23-24 . 40, 42-43, 46, 57 

Mission Planning and Analysis Division (MPAD) 
5 

mixed data (M) 

25, 74, flfi 

MODE command 

42-43 . 52, 71 


12 


♦ 


I 







1 




modes, of editor 
42-43, 46 

modification, of abstracts s*>e M so ABSTRACT command; CHANGE command 

54-55, 66 

modification, of data elements soe ASSIGN command 

modification, of file names see RENAME command 

modification, of tables 
40, 42, 46, 66-67 

movement of files 
58-59 

MPAD see Mission Planning and Analysis Division 

5 


names •••••• see also data element names, file names, personal date base names 

66 

nested blocks 
77, 79 

NEWS command 
32, 00-81 

news file 
81 

NOTE statement 

29, 32, 51-52, 72 

NUMBER command 
32, 51 

numerical data see also Jouble precision; Inteqer; real 

25, 66, 69 


OFF command 

28, 32, 36-37 

OFP see Operational Flight Profile 

Operational Flight Profile (OFP) 

5, 7, 10-13, 15, 26, 30 

operators, rel at I one I 
76-77 
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optional parameters. In commands 
32 


optional values 

22-23 . 42, 49, 57, 70 


E 

PAGE key 
34 


parameter keyword 
21, 43-44, 46 

Payload Integration Plan (PIP) 

5, 7, 13, 15, 30 

PD see Personal Data Base 

PDB see Personal Data Base 

PERFORM command 

28-29, 32-33, 38-39, 52, 70-71 . 72, 84 

permanent storage 
17, 58-59 

Personal Data Base (PDB) (PD) 

16-12, 18-21, 23, 28, 36, 40-41, 54-55, 58-64, 66, 68, 73 

Personal Data Base names 
59, 64-65 

PIP see Payload Integration Plan 

print line I Imlt 
73 

printer see line printer 

processor see X processor; Y processor 

prompt symbol, \ ( I T editor) 

40, 46 

prompt symbol, > (YDT editor) 

40 

prompt symbol, < (LT editor) 

40 

prompt symbol, l (Executive) 

11 , 32, 37, 62, 81 

prompt symbol, # (ST editor) 

40, 52 

prompt symbol, $ (semiautomatic execution) 

72 
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prompt symbols 
15, 40 

prompting 

15, 44, 46, 80 



quick reference to commands 
xi, 2, 3 


I 

I 

I 


fi 

random access memory 

16, 18, 20, 37, 74 

range (iteration specification) 

75- 77, 79 

real data (R) 

21, 74 

reference documents, other than user guide 
3 

relational operators 

76- 77 


remote job entry (RJE) 

13, 15, 30 

RENAME command 
21, 32, 

renumber I ng, automat I c 
67 

renumbering, of table entries see NUMBER command; renumbering automatic 

repeat list 

41 

repetition factor 

47 


repetitive execution see Iterative execution 

required parameters, in commands 
32 
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required values. In interface tables 
22=21 , 42, 48-49, 70 


f 


retrieval of stored files 
58-59 


RETURN key see carriage return 


sample commands 
Appendix Z, 3 

search I nq, for Information ,n tables 
68-69 

SEMIAUTOMATIC command 
32 , 39 , 12=21 

semiautomatic execution mode 
15 , 28 , 38 - 22 , 51 

Sequence Table (ST) 

18 - 12 , 20 - 21 , 2fb22, 33 , 38 - 39 , 41 , 54 - 56 , 60 - 62 , 64 - 68 , 71-73 

Sequence Table editing 

14 , 28 , 33 , 40 - 43 , 5flr» 

sequence table execution 
72-73 


Sequence Table execution, at slgn-ou 
36-37 


SHIFT key 
34 

Shuttle Payload Integration and Development Program Office (SPIDPO) 
5 

sign-off see also OFF command 

63 


sign-on 

34, 36=37 

simulation 

7 , 11-12 

single precision data see real data 

span (group of table entries) 

56 , 62 - 63 , 66 - 67 , 69 , 72-73 

SPIDPO see Shuttle Payload Integration and Development Program Office 

ST see Sequence Table 

standardized f I Ights 
6 , 10 , 17 , 59 


116 



statement (command In sequence table) 

28, 21, 43, 71-73 

status display 
38-39 

STORE command 

20-21, 32, 58-59 . 62-63, 65 

string data see character data; string literals 

string I Iteral s 

55, 66, 69, 75 

subscr I pts 

18, 25, 47, 56. 75 

SUBSTITUTE command 
5fir5S, 65 

Subsystem X 
12 

Subsystem Y 
12 

summary blocks. In user guide 

1 

Supertape 

7 


syntax of commands 
32, 44-45 

system messages 
38-39 

system status display 
80 


I 

table see file; Interface Table; Linkage Table; Sequence Table; Y-data Table 

table of contents see TOC command 

Tektronix terminal 

20=21, 2Ar35 

terminal type 
34, 36-37 

Time data (T) 

25, 57, 74, Appendix D 
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TOC command 

32, 37, 6Qr£j 

trace option 
51, 72-73 

trajectory analysis 

4, 10-11 

transaction log 
80 

transmission of messages 
80-81 

tutorial aids see help 


11 

Uni vac 1108 comp jte~ 
IQ-31 

UNTIL (DO LOOP) 

78-79 


UPDATE mode (editor) 

42-43 . 44, 46, 48, 51-52, 70 

update notices 
81 


1 

val ue 

24-25 r 43, 67, 71 

variables 

22 

Versatek printer/plotter 

20=2 1 

h 

warnings 

38 


WHILE (DO LOOP) 
78-79 



x ^ 


X Job 

20, 54-55, 60, 66, 73 

XP see X Processor 

X Processor 

12-16, 18-20, 22-23, 26-27 . 30, 34, 41, 46, 49, 54-55, 60, 68, 70-71, 82-83 

X Processor attributes 

21 , 2Q-71 

X Processor execution 

14-15, 22-23, 29, 70-71 . 72-73 

X Processor Input and output 
22 = 21 , 26 

X Processor messages 
38 

X Processor termination see abnormal processor termination 

X Processor User Reference Manual 
3, 21 

Xerox VT-3 Word Processing System 
7, 13-15, 30-31 . 82-85 


1 

YD see Y-Data Table 


Y-Oa+a Table (YDT) 

18-19, 20, 54-56, 60-62, 64, 66-68 

Y-Data Table editing 
14, 40-43, 51 

Y-Input Data (YID) 

19 


YJ see Y job, Y Output Data 

Y job 

54-55, 60, 62, 66 


YM0VE command 
20-21, 32 

Y Output Data (YOD) (YJ) 

16-12, 18-21, 54-56, 60, 62, 66, 68 


YP see Y Processor 


Y Processor 

12-21, 30, 54-55, 60 


I 19 


Y Processor execution 

14-15 

Y Processor User Reference Manual 

3 

YRUN command 
32 
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APPENDIX X — GUIDE TO COMMON OPERATIONS 


Opera ti on Command 

Copying, of flies COPY 

Creation, of abstracts ABSTRACT 

of data elements ALLOCATE 

of personal data bases STORE, SUBSTITUTE 

of tables EDIT 

Deletion, of files DELETE 

of lines from table DELETE 

of personal data bases DELETE 

Display, of abstracts ABSTRACT 

of available processor names TCC 

of files LIST 

of mixed data formats FORMAT 

of names of available data bases TOC 

of names of outstanding jobs TOC 

of system news NEWS 

of system status BREAK 

of table of contents TOC 

of transaction log DLOG 

of X Processor attributes ATTRIBUTES 

Duplication, of lines In table INSERT 

of tables COPY 


Editing, of tables 


EDIT 


Execution, conditional 

Iterative 

of seqt.ance tables 
of X Processors .. 


IF 

DO LOOP 

AUTOMATIC, BATCH, SEMIAUTOMATIC 
PERFORM 


Initialization, of Active Work Area CLEAR, GET 

of data elements ASSIGN 


Insertion, of lines In table 

Merging, of tables 

Modification, of abstracts 

of data elements 

of file names 

of tables 

Movement, of files 

Renumbering of tables 

Searching, for Information In tables 

Sign off 


INSERT 

INSERT 

ABSTRACT, CHANGE 

ASSIGN 

RENAME 

EDIT, CHANGE, INSERT, DELETE 
APPEND, GET, STORE, SUBSTITUTE 
NUMBER 

CROSS REFERENCE, FIND 
OFF 
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APPENDIX Y — INDEX TO COMMANDS 




% 


ABSTRACT 54 

ALLOCATE 74 

APPEND 58 

ASSIGN 74 

ATTRIBUTES 70 

AUTOMATIC 72 

BATCH 72 

BREAK 80 

CHANGE 66 

CLEAR 62 

COPY 64 

CROSS REFERENCE 68 

DELETE 62 

DLOG 80 

DO LOOP 78 

EDIT 40 

ELSE 76 

END IF 76 

END LOOP 78 

EXIT 40 

FIND 68 


FORMAT 80 

GET 58 

IF 76 

INSERT 66 

LIST 56 

MESSAGE 80 

MODE 42 

NEWS 80 

NOTE 50 

NUMBER 50 

OFF 36 

PERFORM 70 

RENAME 64 

SEMIAUTOMATIC 72 

Sign-on 36 

STORE 58 

SUBSTITUTE 58 

TOC 60 

YMOVE TBS 

YRUN TBS 
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APPENDIX Z — QUICK REFERENCE TO COMMANDS 


The following are sample commands. They are Intended to be typical, but do not exhaust 
the possible uses and parameters associated with the commands. 

FDS S IGN0N:HR, INIT-PD, INIT1 
ABSTRACT, GPMP-XP 

ABSTRACT, 0MS2- IT, "INTERFACE TABLE FOR OMS-2 BURN" 

ALLOCATE , NUMVAL- 1 T , TWOD I MEN ( 21 , 4 ) -DE 
APPEND, EXPL 

APPEND , EXPL , 0MS2- I T, RESULT 
ASS IGN,NUMVAL=20; 

ASSIGN, TW0DIMEN(21, I >-26.2*0NEDIMEN< I ) • 1=2,4; 

ATTR I BUTE S , GPMP-XP 
ATTR I BUTE S , GPMP-XP , APSOPT , SUMTABL E 
AUTOMAT I C , TR A J ECT ( 20-23 0 ) 

BATCH, EXPL -PD , TRA JECT 
BREAK 

CHANGE , TR A J ECT-ST , 0MS2 , 0MS2A 
CLEAR 

COPY , OMS2- I T , 0MS2 A 
CROSS REFERENCE, -ST,OMS2- IT 
DELETE, EXPL-PD 
DELETE, (20-40) 

DLOG-P 

DO LOOP, WHILE, l<10; 

(statements) 

LOOP END 

DO LOOP, UNTIL, I >=10; 

(statements) 

LOOP END 

EDIT,,0MS2B- IT,GPMP 
EDIT,,TRAJECT-ST 
EXIT 

F I ND,TRAJECT-ST,0MS2 
FIND, (40-200), X+16 
FORMAT, M3 1 ,M33 
GET, EXPL-PD 
GET, ! !FL IGHT-MD,- IT 
I F, I <1 0; 

(statements ) 

END IF 
IF, I <10; 

(statements) 

ELSE 

(statements) 

END IF 

I NSERT,TRAJECT(50-1 00) -ST, 20 
L I ST-P,TRAJECT-ST 

MESSAGE, AB," I f VE FINISHED THE OMS-2 TABLE” 

MODE, I 
NEWS 

NOTE , ”UPPER STAGE MANEUVERS” 

NUMBER 
OFF 

PERFORM, GPMP,OMS2 
RENAME ,OMS2- IT,OMS2A 
SEMIAUTOMATIC, TRAJECT 
STORE, EXPL 

STORE, EXPL, TRAJECT-ST 
SUBSTITUTE, EXPL 
SUBSTI TUTE , EXPL , TR A J ECT- ST 
TOC 

TOC-P,, EXPL-PD 
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